Supabase Agent Skills

Battle-tested database expertise from Supabase, packaged as AI agent skills. These skills provide AI coding agents with proven patterns for building and optimizing production Postgres applications.

Skills follow the Agent Skills format.

Installation

npx skills add supabase/agent-skills

Claude Code Plugin

You can also install the skills in this repo as Claude Code plugins

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

Available Skills

postgres-best-practices

Postgres performance optimization guidelines from Supabase. Contains rules across 8 categories, prioritized by impact.

Use 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:

Query Performance (Critical)
Connection Management (Critical)
Schema Design (High)
Concurrency & Locking (Medium-High)
Security & RLS (Medium-High)
Data Access Patterns (Medium)
Monitoring & Diagnostics (Low-Medium)
Advanced Features (Low)

Usage

Skills are automatically available once installed. The agent will use them when relevant tasks are detected.

Examples:

Optimize this Postgres query

Review my schema for performance issues

Help me add proper indexes to this table

Skill Structure

Each skill contains:

SKILL.md - Instructions for the agent
AGENTS.md - Compiled rules document (generated)
rules/ - Individual rule files
metadata.json - Version and metadata

License

MIT

1.8 KiB Raw Blame History