agent-skills
Agent Skills to help developers using AI agents with Supabase
What is agent-skills?
Agent Skills to help developers using AI agents with Supabase
Overview of agent-skills
What it is
Agent Skills is an open-source repository by Supabase that provides structured instruction sets, scripts, and resources for AI agents. These skills help developers use AI agents more accurately and efficiently when working with Supabase products. The repository is compatible with 18 or more AI agents, including Claude Code, GitHub Copilot, Cursor, and Cline. Each skill follows the Agent Skills format and includes a manifest file (SKILL.md) with name, description, and metadata, along with optional reference files.
Key features
- Provides two main skills:
supabase(comprehensive Supabase development) andsupabase-postgres-best-practices(Postgres performance optimization). - The
supabaseskill covers all Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues) and client library integrations (supabase-js, @supabase/ssr) with frameworks like Next.js, React, SvelteKit, Astro, and Remix. - The
supabase-postgres-best-practicesskill contains references across 8 categories prioritized by impact, including Query Performance, Connection Management, Schema Design, Concurrency & Locking, Security & RLS, Data Access Patterns, Monitoring & Diagnostics, and Advanced Features. - Skills can be installed individually or all at once using the
npx skills addcommand. - Supports installation as Claude Code plugins via the
claude plugincommand. - Includes a
.well-knowndiscovery mechanism that publishes adist/index.jsonfile with each release, conforming to the agent-skills.well-knownURI spec (schema v0.2.0).
Use cases
- Working with any Supabase product, such as Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, or Queues.
- Using client libraries and SSR integrations in Next.js, React, SvelteKit, Astro, or Remix.
- Troubleshooting auth issues including login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, and RLS.
- Using the Supabase CLI or MCP server.
- Working with schema changes, migrations, security audits, or Postgres extensions (pg_graphql, pg_cron, pg_vector).
- Writing SQL queries, designing schemas, implementing indexes, optimizing query performance, configuring connection pooling, or reviewing database performance issues.
- Working with Row-Level Security (RLS).
Getting started
bash# Install all skillsnpx skills add supabase/agent-skills# Install a specific skillnpx skills add supabase/agent-skills --skill supabasenpx skills add supabase/agent-skills --skill supabase-postgres-best-practicesFor detailed installation instructions, see the Supabase AI Skills documentation.
License and pricing
The license is MIT. The pricing type is open source.
Based on the project's public README and repository metadata.