Supabase Agent Skills: Supabase and Postgres for Claude

npx skills add supabase/agent-skills

Supabase Agent Skills are official skills from Supabase that help AI agents build on Supabase accurately. There are two: a comprehensive supabase skill covering every Supabase product, and supabase-postgres-best-practices, a prioritized Postgres performance guide that is useful even outside Supabase.

Who it is for

Developers building on Supabase who keep hitting auth, SSR cookie or RLS mistakes in AI-generated code, and anyone who wants solid Postgres performance guidance in their agent.

What it covers

• supabase: Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron and Queues; client libraries and SSR (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro and Remix; auth troubleshooting (sessions, JWT, cookies, getSession vs getUser vs getClaims, RLS); the Supabase CLI and MCP server; migrations, security audits and extensions like pg_graphql, pg_cron and pgvector.
• supabase-postgres-best-practices: query and schema design, indexing, connection pooling and scaling, and Row Level Security, across 8 impact-ranked categories.

Install

All skills:

npx skills add supabase/agent-skills

Or as Claude Code plugins:

claude plugin marketplace add supabase/agent-skills
claude plugin install supabase@supabase-agent-skills
claude plugin install postgres-best-practices@supabase-agent-skills

Example prompts

Add email magic-link auth to this Next.js app with @supabase/ssr
Why does this RLS policy block inserts for authenticated users?
Review this schema and suggest indexes for the slow dashboard queries
Set up a nightly pg_cron job that archives old rows

Tips and limits

• Combine with the Supabase MCP server in read-only mode so Claude checks real schemas.
• Auth guidance changes as Supabase evolves; keep the skills updated with npx skills update.
• Best-practice rules are a starting point; confirm with EXPLAIN ANALYZE on real data.

Related: DBHub, react-best-practices, skills guide.