Skills Agentes

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.6k

en todo el repo

Actividad
58

0–100, la ruta de este skill

Actualizado
el mes pasado

último commit aquí

Commits
4

ú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. Ver el pack agent-skills entero y su comando de instalación

    Ú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
    el mes pasado
    Oficialbases de datos

    Skills relacionados

    Ú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
    el mes pasado
    Oficialbases de datos

    Debes usarlo antes de cualquier trabajo creativo: crear features, construir componentes, añadir funcionalidad o modificar comportamiento. Explora la intención, requisitos y diseño antes de implementar.

    Costo de contexto al activarse
    3.9k tok
    Tamaño del paquete
    8 archivos
    Última actualización
    el mes pasado
    productividad

    Úsalo cuando enfrentes 2 o más tareas independientes que puedan trabajarse sin estado compartido ni dependencias secuenciales.

    Costo de contexto al activarse
    1.5k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 2 meses
    automatizacion