Supabase Agent Skills

Agent Skills to help developers using AI agents with Supabase. They 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.

When to Use

supabase

Use this skill 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

Use this skill 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 (prioritized by impact):

• 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)

Core Capabilities

• supabase: Comprehensive Supabase development skill covering all Supabase products and integrations. Includes guidance for Auth, client libraries, CLI, MCP, schema changes, migrations, security audits, and Postgres extensions.
• supabase-postgres-best-practices: Postgres performance optimization guidelines from Supabase, with references across 8 categories prioritized by impact.

How It Works

Once installed, the skills are automatically available to your AI agent. When it detects a relevant task, the agent uses the instructions and references from the skill to perform the task more accurately and efficiently. You simply describe your task in natural language.

What You Need to Provide

Your natural language request or question related to Supabase or Postgres. For example:

• "Optimize this Postgres query"
• "Review my schema for performance issues"
• "Help me set up Supabase Auth with Next.js"
• "Help me add proper indexes to this table"

What You Get

The agent uses the skill's guidelines to produce accurate results, such as:

• Optimized SQL queries
• Schema design recommendations
• Index suggestions
• Auth configuration steps
• Troubleshooting guidance for auth or performance issues

Usage Examples

Optimize this Postgres query

Review my schema for performance issues

Help me set up Supabase Auth with Next.js

Help me add proper indexes to this table

Skill Selection

• Use supabase for any task involving Supabase products, client libraries, Auth, CLI, or schema management.
• Use supabase-postgres-best-practices for Postgres performance optimization, query tuning, index design, connection pooling, and RLS review.

Notes

• Compatible with 18+ AI agents, including Claude Code, GitHub Copilot, Cursor, Cline, and others.
• Skills are automatically used by the agent when relevant tasks are detected; no manual activation required.
• No additional API keys, accounts, or configuration beyond the AI agent itself are needed.