What it does
Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, declarative schemas, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector); debugging and troubleshooting errors or unexpected behavior on Supabase projects (HTTP errors, Postgres errors, RLS surprises, permission denied, schema cache issues, timeouts, Edge Function crashes, Realtime drops, Storage failures) and reading or querying logs (Logs Explorer, ClickHouse).
This entry summarizes the public skill for discovery. Prefer the upstream SKILL.md for the full instruction text (we do not paste restricted or lengthy proprietary prompt bodies).
Install & usage
Official installer
npx skills add supabase/agent-skills --skill supabase
# or all skills:
npx skills add supabase/agent-skills
See also: https://supabase.com/docs/guides/getting-started/ai-skills
Best for
Any Supabase product work (Auth, DB, Edge Functions, RLS, etc.).
Hands-on test
- test_level: installed-validated
- Ran: yes
- When: 2026-11-01T01:20:00+08:00 (Asia/Shanghai)
- Result: Drafted tenant-scoped schema + RLS notes from skill; supabase CLI absent and no linked project (login/cloud skipped).
- Gotchas: Full skill path wants supabase CLI + project credentials.
Money-saving tip
Skill is free (MIT). Use free Supabase project tiers for prototypes; load postgres-best-practices before designing schemas to avoid costly rework.
Source & license
- source_repo: supabase/agent-skills
- Source: https://github.com/supabase/agent-skills/tree/main/skills/supabase
- License: MIT — https://github.com/supabase/agent-skills/blob/main/LICENSE
- Restrictions: MIT. Follow Supabase ToS; never commit service-role keys.