supabaseAgent Skills to help developers using AI agents with Supabase
·
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 format.
Installation
See the Supabase AI Skills documentation 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
supabase
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)
supabase-postgres-best-practices
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:
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 (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 on every semver release.
Migrating to the official GitHub Action
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:
- 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.
Install with your agent
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/skill/supabase-agent-skills to learn what the "Supabase Agent Skills" skill does and how to install it. Install it for my coding agent as documented on that page, then confirm the skill is available and summarize what it can do.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
Install manually
Claude Code
- Run the install command below in your terminal.
- The skill files land in your ~/.claude/skills directory, laid out as shown.
- Restart Claude Code or start a new session. Skills are discovered on startup.
git clone --depth 1 https://github.com/supabase/agent-skills.git ~/.claude/skills/supabase-agent-skills
rm -rf ~/.claude/skills/supabase-agent-skills/.git~/.claude/skills/supabase-agent-skills
├── SKILL.md
├── .claude-plugin
├── .github
├── .gitignore
├── .mcp.json
├── .node-version
├── .release-please-manifest.json
├── AGENTS.md
├── CHANGELOG.md
├── CLAUDE.md
├── CONTRIBUTING.md
├── LICENSE
├── assets
├── package.json
├── pnpm-lock.yaml
├── release-please-config.json
├── scripts
├── skills
├── test
└── vitest.config.tsFor a single project, put the folder in .claude/skills inside the repo instead.
Any other agent
- Clone the repository with the command below.
- Copy the skill folder into the directory your agent loads skills from.
git clone --depth 1 https://github.com/supabase/agent-skills.gitFrom the project README
npx skills add supabase/agent-skills
npx skills add supabase/agent-skills --skill supabase
<redacted>This listing has no SKILL.md on record yet.
- .claude-plugin
- .github
- .gitignore248 B
- .mcp.json118 B
- .node-version3 B
- .release-please-manifest.json103 B
- AGENTS.md7 KB
- CHANGELOG.md5 KB
- CLAUDE.md9 B
- CONTRIBUTING.md5 KB
- LICENSE1 KB
- assets
- package.json515 B
- pnpm-lock.yaml33 KB
- release-please-config.json1 KB
- scripts
- skills
- test
- vitest.config.ts177 B
Alternatives to Supabase Agent Skills
View all in Coding & Review
Official agent plugin providing skills and MCP server configurations for Azure scenarios.
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check acc
Use this skill any time a spreadsheet file is the primary input or output. This means any task where
v0.1.8Release notesv0.1.7Release notesv0.1.6Release notesv0.1.5Release notesv0.1.4Release notesv0.1.3Release notesv0.1.2Release notesv0.1.1Release notes
Send this prompt to your agent to leave a review
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "supabase-agent-skills" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
Related Skills
Official agent plugin providing skills and MCP server configurations for Azure scenarios.
Coding & Review
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check acc
Coding & Review
Use this skill any time a spreadsheet file is the primary input or output. This means any task where
Data Processing
Subscribe to our newsletter
One email a week. New agents, MCP servers and skills, and what is actually getting traction.