ASD

Supabase Postgres Best Practices

Buenas prácticas de Postgres de Supabase, para usar antes de escribir o cambiar cualquier cosa en una base Postgres: tablas, migraciones, RLS, índices, triggers, funciones, colas, pgvector y restauración de dumps.

Oficial
Estrellas
2.5k

en todo el repo

Actividad
66

0–100, la ruta de este skill

Actualizado
hace 15 días

último commit aquí

Commits
8

últimos 90 días

Contexto
808 tok

209 tok en reposo

Paquete
36 archivos

61 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add supabase/agent-skills --skill supabase-postgres-best-practices --agent claude-code

Se instala solo en este repositorio.

Qué hace

  • Aplica reglas de buenas prácticas de Postgres antes de crear o modificar tablas, columnas, migraciones, RLS, índices, triggers, funciones o colas
  • Guía el diagnóstico de consultas lentas, alto CPU, timeouts, planes EXPLAIN, agotamiento de conexiones, locking y bloat
  • Organiza las reglas en 8 categorías priorizadas por impacto, con ejemplos SQL correctos e incorrectos

Úsalo cuando

  • Al escribir consultas SQL o diseñar esquemas
  • Al implementar índices u optimización de consultas
  • Al revisar problemas de rendimiento de la base de datos
  • Al trabajar con Row-Level Security (RLS)

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • Voy a crear una tabla nueva, ¿qué reglas de Postgres debo seguir
    • Esta consulta va lenta, ayúdame a diagnosticarla con EXPLAIN
    • Quiero escribir una política RLS para esta tabla
    • Necesito restaurar un dump con pg_restore, ¿hay algo que considerar

    SKILL.md

    En inglés

    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/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

    Reproducido de supabase/agent-skills bajo licencia MIT. Leer esta página en markdown.

    Archivos

    36 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    Detalles

    Creador
    supabase
    Categoría
    Bases de datos
    Licencia
    MIT
    Recursos incluidos
    referencias
    Código fuente
    Ver SKILL.md

    Etiquetas

    Más de supabase/agent-skills

    Este repo incluye 2 skills. Si instalas uno, normalmente ya tienes los demás.

    Úsalo para cualquier tarea con Supabase: productos, clientes SSR, auth, CLI o MCP, cambios de esquema, auditorías de seguridad y depuración de errores o logs.

    Costo de contexto al activarse
    3.2k tok
    Tamaño del paquete
    4 archivos
    Última actualización
    anteayer
    Oficialbases de datos

    Skills relacionados

    Úsalo al completar tareas, implementar features mayores, o antes de mergear, para verificar que el trabajo cumple los requisitos.

    Costo de contexto al activarse
    739 tok
    Tamaño del paquete
    2 archivos
    Última actualización
    anteayer
    testing qa

    Úsalo antes de afirmar que un trabajo está completo, corregido o pasando, antes de hacer commit o crear PRs: exige ejecutar comandos de verificación y confirmar la salida antes de cualquier afirmación de éxito.

    Costo de contexto al activarse
    912 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    el mes pasado
    testing qa

    Domina la optimización de consultas SQL, estrategias de indexado y análisis EXPLAIN para mejorar drásticamente el rendimiento de la base de datos y eliminar consultas lentas.

    Costo de contexto al activarse
    1.5k tok
    Tamaño del paquete
    2 archivos
    Última actualización
    hace 2 meses
    bases de datos