supabase-postgres-best-practices▌
davila7/claude-code-templates · updated Apr 8, 2026
Comprehensive performance optimization guide for Postgres, maintained by Supabase. Contains rules across 8 categories, prioritized by impact to guide automated query optimization and schema design.
Supabase Postgres Best Practices
Comprehensive performance optimization guide for Postgres, maintained by Supabase. Contains rules across 8 categories, prioritized by impact to guide automated query optimization and schema design.
When to Apply
Reference these guidelines when:
- Writing SQL queries or designing schemas
- Implementing indexes or query optimization
- Reviewing database performance issues
- Configuring connection pooling or scaling
- Optimizing for Postgres-specific features
- Working with Row-Level Security (RLS)
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Query Performance | CRITICAL | query- |
| 2 | Connection Management | CRITICAL | conn- |
| 3 | Security & RLS | CRITICAL | security- |
| 4 | Schema Design | HIGH | schema- |
| 5 | Concurrency & Locking | MEDIUM-HIGH | lock- |
| 6 | Data Access Patterns | MEDIUM | data- |
| 7 | Monitoring & Diagnostics | LOW-MEDIUM | monitor- |
| 8 | Advanced Features | LOW | advanced- |
How to Use
Read individual rule files for detailed explanations and SQL examples:
rules/query-missing-indexes.md
rules/schema-partial-indexes.md
rules/_sections.md
Each rule file contains:
- Brief explanation of why it matters
- Incorrect SQL example with explanation
- Correct SQL example with explanation
- Optional EXPLAIN output or metrics
- Additional context and references
- Supabase-specific notes (when applicable)
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.6★★★★★59 reviews- ★★★★★Diya Singh· Dec 28, 2024
I recommend supabase-postgres-best-practices for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Pratham Ware· Dec 24, 2024
Keeps context tight: supabase-postgres-best-practices is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Lucas Choi· Dec 12, 2024
Solid pick for teams standardizing on skills: supabase-postgres-best-practices is focused, and the summary matches what you get after install.
- ★★★★★Diya Robinson· Dec 8, 2024
Registry listing for supabase-postgres-best-practices matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Meera Thomas· Dec 4, 2024
Keeps context tight: supabase-postgres-best-practices is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Diya Srinivasan· Nov 27, 2024
supabase-postgres-best-practices fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Naina Sethi· Nov 23, 2024
supabase-postgres-best-practices has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Yash Thakker· Nov 15, 2024
supabase-postgres-best-practices has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Diya White· Nov 3, 2024
Useful defaults in supabase-postgres-best-practices — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Isabella Garcia· Nov 3, 2024
supabase-postgres-best-practices is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
showing 1-10 of 59