supabase-postgres-best-practices
Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.
- License 许可
- MIT
- 最近更新
- 2026-04-06
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- supabase-postgres-best-practices
- license
- MIT
- metadata
- { "date": "January 2026", "author": "supabase", "version": "1.1.0", "abstract": "Comprehensive Postgres performance optimization guide for developers using Supabase and Postgres. Contains performance rules across 8 categories, prioritized by impact from critical (query performance, connection management) to incremental (advanced features). Each rule includes detailed explanations, incorrect vs. correct SQL examples, query plan analysis, and specific performance metrics to guide automated optimization and code generation.", "organization": "Supabase" }
- description
- Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.
02 资源文件 34
- 参考文档AGENTS.md2.1 KB
- 参考文档CLAUDE.md2.1 KB
- 参考文档README.md3.1 KB
- 参考文档references/advanced-full-text-search.md1.4 KB
- 参考文档references/advanced-jsonb-indexing.md1.4 KB
- 参考文档references/conn-idle-timeout.md1.3 KB
- 参考文档references/conn-limits.md1.3 KB
- 参考文档references/conn-pooling.md1.3 KB
- 参考文档references/conn-prepared-statements.md1.5 KB
- 参考文档references/data-batch-inserts.md1.3 KB
- 参考文档references/data-n-plus-one.md1.3 KB
- 参考文档references/data-pagination.md1.3 KB
- 参考文档references/data-upsert.md1.4 KB
- 参考文档references/lock-advisory.md1.5 KB
- 参考文档references/lock-deadlock-prevention.md1.8 KB
- 参考文档references/lock-short-transactions.md1.3 KB
- 参考文档references/lock-skip-locked.md1.3 KB
- 参考文档references/monitor-explain-analyze.md1.4 KB
- 参考文档references/monitor-pg-stat-statements.md1.4 KB
- 参考文档references/monitor-vacuum-analyze.md1.5 KB
- 参考文档references/query-composite-indexes.md1.4 KB
- 参考文档references/query-covering-indexes.md1.3 KB
- 参考文档references/query-index-types.md1.5 KB
- 参考文档references/query-missing-indexes.md1.2 KB
- 参考文档references/query-partial-indexes.md1.3 KB
- 参考文档references/schema-constraints.md1.8 KB
- 参考文档references/schema-data-types.md1.4 KB
- 参考文档references/schema-foreign-key-indexes.md1.6 KB
- 参考文档references/schema-lowercase-identifiers.md1.7 KB
- 参考文档references/schema-partitioning.md1.5 KB
- 参考文档references/schema-primary-keys.md1.8 KB
- 参考文档references/security-privileges.md1.5 KB
- 参考文档references/security-rls-basics.md1.3 KB
- 参考文档references/security-rls-performance.md1.5 KB
03 SKILL.md 正文
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:
references/query-missing-indexes.md
references/schema-partial-indexes.md
references/_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)
References
04 同仓库更多 Skills
seo-content-writer
Use when the user asks to "write SEO content", "create a blog post", "write an article", "content writing", "draft optimized content", "write me an article", "create a blog post about", "help me write SEO content", or "draft content for". Creates high-quality, SEO-optimized content that ranks in search engines. Applies on-page SEO best practices, keyword optimization, and content structure for maximum visibility and engagement. For AI citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.
pptx-generator
Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML workflows, or extract text with markitdown. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides.
minimax-xlsx
Open, create, read, analyze, edit, or validate Excel/spreadsheet files (.xlsx, .xlsm, .csv, .tsv). Use when the user asks to create, build, modify, analyze, read, validate, or format any Excel spreadsheet, financial model, pivot table, or tabular data file. Covers: creating new xlsx from scratch, reading and analyzing existing files, editing existing xlsx with zero format loss, formula recalculation and validation, and applying professional financial formatting standards. Triggers on 'spreadsheet', 'Excel', '.xlsx', '.csv', 'pivot table', 'financial model', 'formula', or any request to produce tabular data in Excel format.
minimax-pdf
Use this skill when visual quality and design identity matter for a PDF. CREATE (generate from scratch): "make a PDF", "generate a report", "write a proposal", "create a resume", "beautiful PDF", "professional document", "cover page", "polished PDF", "client-ready document". FILL (complete form fields): "fill in the form", "fill out this PDF", "complete the form fields", "write values into PDF", "what fields does this PDF have". REFORMAT (apply design to an existing doc): "reformat this document", "apply our style", "convert this Markdown/text to PDF", "make this doc look good", "re-style this PDF". This skill uses a token-based design system: color, typography, and spacing are derived from the document type and flow through every page. The output is print-ready. Prefer this skill when appearance matters, not just when any PDF output is needed.
minimax-docx
Professional DOCX document creation, editing, and formatting using OpenXML SDK (.NET). Three pipelines: (A) create new documents from scratch, (B) fill/edit content in existing documents, (C) apply template formatting with XSD validation gate-check. MUST use this skill whenever the user wants to produce, modify, or format a Word document — including when they say "write a report", "draft a proposal", "make a contract", "fill in this form", "reformat to match this template", or any task whose final output is a .docx file. Even if the user doesn't mention "docx" explicitly, if the task implies a printable/formal document, use this skill.
clawiser
Agent 记忆与工作流增强套件。包含 8 个模块:记忆系统(memory-deposit、retrieval-enhance、noise-reduction)+ 工作流(hdd、sdd、save-game、load-game、project-skill-pairing)。当用户说"安装 ClaWiser"、"初始化 ClaWiser"、"运行 ClaWiser"时触发。