mirror of
https://github.com/supabase/agent-skills.git
synced 2026-01-26 19:09:51 +08:00
34b421243c
* feat: add marketplace.json for Claude Code plugin distribution Add .claude-plugin/marketplace.json to enable distribution of the postgres-best-practices skill as a Claude Code plugin. Users can install via: /plugin marketplace add supabase/agent-skills /plugin install postgres-best-practices@supabase-postgres Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * feat: add plugin.json manifest for postgres-best-practices skill Add .claude-plugin/plugin.json inside the skill directory to properly define this as a Claude Code plugin. This is required by the marketplace specification - each plugin must have its own plugin.json manifest. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * chore: update marketplace name and description for broader scope - Rename marketplace from supabase-postgres to supabase-plugins - Update description to reflect this as the official Supabase agent skills repo Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * minor fixes --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Agent Skills
A collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities.
Skills follow the Agent Skills format.
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)
Installation
npx skills add supabase/agent-skills
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 agentAGENTS.md- Compiled rules document (generated)rules/- Individual rule filesmetadata.json- Version and metadata
License
MIT