mirror of
https://github.com/supabase/agent-skills.git
synced 2026-01-26 19:09:51 +08:00
80 lines
1.6 KiB
Markdown
80 lines
1.6 KiB
Markdown
# 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](https://agentskills.io/) format.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npx skills add supabase/agent-skills
|
|
```
|
|
|
|
### Claude Code Plugin
|
|
|
|
You can also install the skills in this repo as Claude Code plugins
|
|
|
|
```bash
|
|
/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
|