Supabase Agent Skills

Supabase Agent Skills is an open-source repository of structured instruction sets that AI coding agents can discover and load on demand to perform Supabase-related tasks more accurately. Published by Supabase under the MIT license, the project follows the Agent Skills open standard and is compatible with 18+ AI agents including Claude Code, GitHub Copilot, Cursor, and Cline. It is installed via the skills CLI using a single npx skills add supabase/agent-skills command.

What It Is

Agent Skills are folders of instructions, scripts, and references that agents can discover and use to extend their capabilities based on the task at hand. Rather than relying on an agent's general training, skills supply team- and product-specific procedural knowledge — covering Supabase products, client libraries, auth patterns, schema design, and Postgres best practices — so agents can do real work reliably without needing that context baked into the model.

Available Skills

The repository currently ships two skills:

• supabase — A comprehensive skill covering all Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues), client libraries (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, and Remix, auth troubleshooting (JWT, cookies, RLS), the Supabase CLI and MCP server, schema migrations, Postgres extensions, and log querying via the Logs Explorer.
• supabase-postgres-best-practices — Postgres performance and safety guidelines maintained by Supabase, organized across eight categories (Query Performance, Connection Management, Schema Design, Concurrency & Locking, Security & RLS, Data Access Patterns, Monitoring & Diagnostics, Advanced Features), prioritized by impact. The docs recommend loading this skill before any schema or SQL authoring task, not just performance work.

Installation and Distribution Model

Skills are installed at project scope by default, placing them in the repository so all contributors and cloud agents share the same setup. A --global flag installs across all projects. The --all flag installs for all detected agents simultaneously. Skills can also be installed as Claude Code plugins via claude plugin install. Supabase also serves skills at https://supabase.com/.well-known/agent-skills/ conforming to the agent-skills .well-known URI spec (schema v0.2.0), enabling discovery by compatible tooling.

Agent Compatibility

The README states compatibility with 18+ AI agents. Named agents include Claude Code, GitHub Copilot, Cursor, and Cline. The skills format follows the Agent Skills Open Standard (agentskills.io), meaning any agent that supports that standard can consume them. Each skill consists of a SKILL.md manifest with frontmatter and an optional references/ directory for detailed documentation.

Update: v0.1.8

The latest release is v0.1.8, published on 2026-08-12. The repository was created in January 2026 and has seen active development, with the GitHub metadata showing 2,512 stars and 186 forks as of the last update. Releases are managed by Release Please and triggered on every semver tag. The project roadmap notes a planned migration to an official agentskills/build-for-well-known GitHub Action as a drop-in replacement for the current build script once it is published to the GitHub Marketplace.