Files
supabase-postgres-best-prac…/README.md
Pedro Rodrigues 6c42207a93 docs: add Claude Code plugin installation instructions
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 15:59:54 +00:00

1.6 KiB

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.

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