Setting the issue. One moment.
Contents
Repo No. 16Supabase · Updated 24 September 2026 · In print
Skills Docs · No. 16
Supabase
supabase / agent-skills
Agent Skills to help developers using AI agents with Supabase
Start reading — 1 min2 skills1,561 words
Inside this issue
1 — Install
npx skills add supabase/agent-skills/plugin marketplace add supabase/agent-skillsMIT2.6k stars1,561 wordsUpdated 24 September 2026
2 — Skills
2 skills · 7 minutesSkills Docs · Repo No. 16Whole repo as markdown
Provenance
- Owner
- supabase · Organization
- Licence
- MIT
- Last updated
- Published from
- github.com/
supabase/ agent-skills
| Week | Installs |
|---|---|
| Week 1 | 25,755 |
| Week 2 | 28,062 |
| Week 3 | 26,251 |
| Week 4 | 27,302 |
| Week 5 | 26,374 |
| Week 6 | 23,049 |
| Week 7 | 22,781 |
| Week 8 | 22,137 |
Typeset in this issue’s own colours, resolved from the awesome-design-md registry.
Front matter
From the README
Supabase Agent Skills
Agent Skills to help developers using AI agents with Supabase. Agent Skills are folders of instructions, scripts, and resources that agents can discover and use to do things more accurately and efficiently. Compatible with 18+ AI agents including Claude Code, GitHub Copilot, Cursor, Cline, and many others.
The skills in this repo follow the Agent Skills (opens in a new tab) format.
Installation
See the Supabase AI Skills documentation (opens in a new tab) for detailed installation instructions.
Install all skills
npx skills add supabase/agent-skillsInstall a specific skill
npx skills add supabase/agent-skills --skill supabase
npx skills add supabase/agent-skills --skill supabase-postgres-best-practicesClaude Code Plugin
You can also install the skills as Claude Code plugins:
# 1. Install supabase/agent-skill marketplace
claude plugin marketplace add supabase/agent-skills
# 2. Install the plugin that you want
claude plugin install supabase@supabase-agent-skills
claude plugin install postgres-best-practices@supabase-agent-skillsAvailable Skills
Comprehensive Supabase development skill covering all Supabase products and integrations.
Use when:
- Working with any Supabase product (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues)
- Using client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix
- Troubleshooting auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS)
- Using the Supabase CLI or MCP server
- Working with schema changes, migrations, security audits, or Postgres extensions (pg_graphql, pg_cron, pg_vector)
Postgres performance optimization guidelines from Supabase. Contains references across 8 categories, prioritized by impact.
Use when:
- Writing SQL queries or designing schemas
- Implementing indexes or query optimization
- Reviewing database performance issues
- Configuring connection pooling or scaling
- Working with Row-Level Security (RLS)
Categories covered:
- Query Performance (Critical)
- Connection Management (Critical)
- Schema Design (High)
- Concurrency & Locking (Medium-High)
- Security & RLS (Critical)
- Data Access Patterns (Medium)
- Monitoring & Diagnostics (Low-Medium)
- Advanced Features (Low)
Usage
Skills are automatically available once installed. The agent will use them when relevant tasks are detected.
Examples:
Optimize this Postgres queryReview my schema for performance issuesHelp me set up Supabase Auth with Next.jsHelp me add proper indexes to this tableSkill Structure
Each skill follows the Agent Skills Open Standard (opens in a new tab):
SKILL.md- Required skill manifest with frontmatter (name, description, metadata)references/- (Optional) Reference files for detailed documentation
.well-known discovery
Each release uploads a dist/index.json alongside the skill tarballs. This index conforms to the agent-skills .well-known URI spec (opens in a new tab) (schema v0.2.0) and is consumed by supabase.com to serve skills at https://supabase.com/.well-known/agent-skills/.
The release artifacts are built by scripts/build-release.ts and triggered by Release Please (opens in a new tab) on every semver release.
Migrating to the official GitHub Action
jonathanhefner/agentskills-build-for-well-known (opens in a new tab) 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:
- name: Build release artifacts
uses: agentskills/build-for-well-known@v1 # replaces pnpm build:release
with:
skills-dir: skills
output-dir: distEverything 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.
Colophon
How this issue was made- Source
- github.com/supabase/agent-skills, branch
main, last pushed 24 September 2026. - Licence
- MIT — the text of every skill is reproduced unmodified, frontmatter included, under the upstream licence.
- Discovery
- 2 skills found by walking the repository tree for
SKILL.md, not by matching a directory convention. One layout observed:skills/*/SKILL.md. - Issue colours
- Resolved from the awesome-design-md registry — hue 159°, chroma 0.154. Two accent tones are generated per issue and each is proven against its own ground before it ships: a single accent that passes AA on both light and dark paper is arithmetically impossible.
- Heading repairs
- 1 repair applied to the front matter so the document has one
h1and no skipped levels:- Shifted “10 headings” from h1 to h2 so the skill title is the only h1.
- Spec compliance
- Every skill satisfies the Agent Skills specification’s frontmatter rules.
- Images
- Images inside a skill come from the upstream repository. Where the author gave no alternative text we mark the image decorative rather than inventing a description — a plausible caption we made up is worse than none for the reader who depends on it.
- Marketplace
- A plugin manifest is published at
.claude-plugin/marketplace.jsonby Supabase, declaring 2 plugins. It is read for editorial metadata only — never as the skill index, which is always the repository tree. - Signal
- Install counts come from skills.sh. They measure downloads, not quality, and an unranked repository is not an unread one.
- Agent surfaces
- The whole issue is available as one markdown document at
/supabase/agent-skills.md, and each skill at its own.mdURL. - Publication
- Set by Skills Docs from the source repository. Body text is Literata at the reader’s chosen size and measure; code is Geist Mono. Nothing on this page was written by us except this paragraph.