{
  "markdown": "![Supabase Agent Skills](assets/og.png)\n\n# Supabase Agent Skills\n\nAgent Skills to help developers using AI agents with Supabase. Agent Skills are\nfolders of instructions, scripts, and resources that agents can discover and use\nto do things more accurately and efficiently. Compatible with 18+ AI agents\nincluding Claude Code, GitHub Copilot, Cursor, Cline, and many others.\n\nThe skills in this repo follow the [Agent Skills](https://agentskills.io/)\nformat.\n\n## Installation\n\nSee the [Supabase AI Skills documentation](https://supabase.com/docs/guides/getting-started/ai-skills)\nfor detailed installation instructions.\n\n### Install all skills\n\n```bash\nnpx skills add supabase/agent-skills\n```\n\n### Install a specific skill\n\n```bash\nnpx skills add supabase/agent-skills --skill supabase\nnpx skills add supabase/agent-skills --skill supabase-postgres-best-practices\n```\n\n### Claude Code Plugin\n\nYou can also install the skills as Claude Code plugins:\n\n```bash\n# 1. Install supabase/agent-skill marketplace\nclaude plugin marketplace add supabase/agent-skills\n\n# 2. Install the plugin that you want \nclaude plugin install supabase@supabase-agent-skills\nclaude plugin install postgres-best-practices@supabase-agent-skills\n```\n\n## Available Skills\n\n<details>\n<summary><strong>supabase</strong></summary>\n\nComprehensive Supabase development skill covering all Supabase products and\nintegrations.\n\n**Use when:**\n\n- Working with any Supabase product (Database, Auth, Edge Functions, Realtime,\n  Storage, Vectors, Cron, Queues)\n- Using client libraries and SSR integrations (supabase-js, @supabase/ssr) in\n  Next.js, React, SvelteKit, Astro, Remix\n- Troubleshooting auth issues (login, logout, sessions, JWT, cookies, getSession,\n  getUser, getClaims, RLS)\n- Using the Supabase CLI or MCP server\n- Working with schema changes, migrations, security audits, or Postgres extensions\n  (pg_graphql, pg_cron, pg_vector)\n\n</details>\n\n<details>\n<summary><strong>supabase-postgres-best-practices</strong></summary>\n\nPostgres performance optimization guidelines from Supabase. Contains references\nacross 8 categories, prioritized by impact.\n\n**Use when:**\n\n- Writing SQL queries or designing schemas\n- Implementing indexes or query optimization\n- Reviewing database performance issues\n- Configuring connection pooling or scaling\n- Working with Row-Level Security (RLS)\n\n**Categories covered:**\n\n- Query Performance (Critical)\n- Connection Management (Critical)\n- Schema Design (High)\n- Concurrency & Locking (Medium-High)\n- Security & RLS (Critical)\n- Data Access Patterns (Medium)\n- Monitoring & Diagnostics (Low-Medium)\n- Advanced Features (Low)\n\n</details>\n\n## Usage\n\nSkills are automatically available once installed. The agent will use them when\nrelevant tasks are detected.\n\n**Examples:**\n\n```\nOptimize this Postgres query\n```\n\n```\nReview my schema for performance issues\n```\n\n```\nHelp me set up Supabase Auth with Next.js\n```\n\n```\nHelp me add proper indexes to this table\n```\n\n## Skill Structure\n\nEach skill follows the [Agent Skills Open Standard](https://agentskills.io/):\n\n- `SKILL.md` - Required skill manifest with frontmatter (name, description, metadata)\n- `references/` - (Optional) Reference files for detailed documentation\n\n## `.well-known` discovery\n\nEach release uploads a `dist/index.json` alongside the skill tarballs. This index conforms to the [agent-skills `.well-known` URI spec](https://github.com/agentskills/agentskills/pull/254) (schema v0.2.0) and is consumed by `supabase.com` to serve skills at `https://supabase.com/.well-known/agent-skills/`.\n\nThe release artifacts are built by `scripts/build-release.ts` and triggered by [Release Please](https://github.com/googleapis/release-please) on every semver release.\n\n### Migrating to the official GitHub Action\n\n[`jonathanhefner/agentskills-build-for-well-known`](https://github.com/jonathanhefner/agentskills-build-for-well-known) is intended to be transferred to the `agentskills` org and published to the GitHub Marketplace. When that happens, `scripts/build-release.ts` and the `pnpm build:release` step in `release-please.yml` can be replaced with the Action directly:\n\n```yaml\n- name: Build release artifacts\n  uses: agentskills/build-for-well-known@v1   # replaces pnpm build:release\n  with:\n    skills-dir: skills\n    output-dir: dist\n```\n\nEverything else — the Release Please trigger, the upload step, the supabase-plugin dispatch — stays exactly the same. The script and the Action produce identical output, so it is a drop-in swap.\n",
  "bytes": 4503,
  "sha": "8922feb4326c0603ff6e56246bf1bf436aa1dd9f50f22212ad1605749e105830",
  "repo_slug": "supabase/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_supabase_agent_skills_skills_supabase_po_0b31fcad/readme"
}