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) and supabase-postgres-best-practices (Postgres performance optimization).
  • The supabase skill 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-practices skill 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 add command.
  • Supports installation as Claude Code plugins via the claude plugin command.
  • Includes a .well-known discovery mechanism that publishes a dist/index.json file with each release, conforming to the agent-skills .well-known URI 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/supabaseagent-skills.svg)](https://yunodb.com/tools/supabaseagent-skills?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/supabaseagent-skills?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/supabaseagent-skills.svg" alt="Featured on YunoDB" height="20"></a>