Postgres Best Practices

Optimización de rendimiento y mejores prácticas de Postgres de Supabase. Usa esta habilidad al escribir, revisar u optimizar consultas de Postgres, diseños de esquemas o configuraciones de base de datos.

npx skills add https://github.com/supabase/agent-skills --skill supabase-postgres-best-practices

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

PriorityCategoryImpactPrefix
1Query PerformanceCRITICALquery-
2Connection ManagementCRITICALconn-
3Security & RLSCRITICALsecurity-
4Schema DesignHIGHschema-
5Concurrency & LockingMEDIUM-HIGHlock-
6Data Access PatternsMEDIUMdata-
7Monitoring & DiagnosticsLOW-MEDIUMmonitor-
8Advanced FeaturesLOWadvanced-

How to Use

Read individual rule files for detailed explanations and SQL examples:

references/query-missing-indexes.md
references/query-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

Skills relacionadas

wiki-onboarding
microsoft
Genera cuatro guías de incorporación adaptadas a la audiencia en una carpeta onboarding/ — Colaborador, Ingeniero de Personal, Ejecutivo y Gerente de Producto. Úsalo cuando el usuario…
official
issue
tldraw
Crear e investigar un issue de GitHub en el repositorio de tldraw a partir de una descripción de usuario. Usar cuando el usuario invoque issue, pida crear un issue, reportar un error,…
official
json-render-react-native
vercel
Renderizador de React Native para json-render que convierte especificaciones JSON en interfaces de usuario nativas para móviles. Úsalo al trabajar con @json-render/react-native, creando interfaces de React Native…
official
write-tests
microsoft
Guía para escribir pruebas unitarias. Úsala al crear pruebas para verificar lógica de Python.
official
dart-modern-features
flutter
Para encontrar candidatos para la modernización:
official
components.styles
coinbase
components.styles — una habilidad instalable para agentes de IA, publicada por coinbase/cds.
official
neki
planetscale
Descripción general e información sobre Neki, el producto Postgres fragmentado de PlanetScale. Cargar al trabajar con tareas relacionadas con Neki y la necesidad de escalar o fragmentar…
official
flutter-databases
flutter
Capa de datos compatible con MVVM para Flutter con patrón Repository, Services sin estado y estrategias inteligentes de caché local. Guía la selección de tecnología de persistencia (shared_preferences, sqflite, drift, hive_ce, isar_community o file I/O) según el tipo de datos, tamaño y complejidad relacional. Implementa Repository como fuente única de verdad, aislando DatabaseService y ApiClient como dependencias privadas sin estado. Proporciona ejemplos de código completos para modelos de dominio, operaciones SQLite y...
official