supabase-postgres-best-practices

Visión general

¿Qué es supabase-postgres-best-practices?

Supabase Postgres Best Practices es una skill seleccionada para ayudar a desarrolladores e ingenieros de bases de datos a optimizar el rendimiento de Postgres. Mantenida por Supabase, esta skill ofrece reglas prácticas y ejemplos para escribir consultas SQL eficientes, diseñar esquemas robustos, gestionar conexiones e implementar las mejores prácticas de seguridad. Cubre ocho categorías clave, incluyendo rendimiento de consultas, gestión de conexiones, seguridad (incluyendo Row-Level Security), diseño de esquemas, concurrencia, patrones de acceso a datos, monitoreo y características avanzadas de Postgres.

¿Quién debería usar esta skill?

• Desarrolladores backend que trabajen con Postgres o Supabase
• Ingenieros de bases de datos que busquen mejorar la fiabilidad y velocidad
• Equipos que revisen o refactoricen consultas SQL y esquemas de bases de datos
• Cualquier persona que configure Postgres para alta concurrencia o entornos serverless

Problemas que resuelve

• Identifica y corrige anti-patrones comunes en Postgres
• Proporciona reescrituras SQL concretas y métricas de rendimiento
• Ayuda a prevenir consultas lentas, cuellos de botella en conexiones y errores de configuración de seguridad
• Ofrece orientación priorizada para mejoras críticas e incrementales

Cómo usar

Pasos de instalación

1. Agrega la skill a tu agente o proyecto:

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

2. Comienza con la documentación principal:
   • Abre SKILL.md para una visión general de todas las mejores prácticas y categorías de reglas.
   • Revisa AGENTS.md para una lista compilada y navegable de todas las referencias.
3. Explora temas detallados:
   • Navega la carpeta references/ para guías profundas sobre temas como búsqueda de texto completo, indexación JSONB, pooling de conexiones y optimización de consultas.
   • Usa el archivo references/_sections.md para entender el impacto y prioridad de cada categoría de reglas.
4. Adáptalo a tu flujo de trabajo:
   • Integra reglas y ejemplos SQL relevantes en tus revisiones de código, migraciones o chequeos automáticos.
   • Consulta README.md para instrucciones de contribución y validación si planeas extender o personalizar la skill.

Archivos y carpetas clave

• SKILL.md: Manifiesto principal de la skill y visión general (léelo primero)
• AGENTS.md: Documentación compilada para agentes
• references/: Guías individuales de mejores prácticas (por ejemplo, query-missing-indexes.md, conn-pooling.md)
• README.md: Instrucciones para contribuyentes y validación

Casos de uso ejemplares

• Refactorizar consultas lentas usando las reglas de rendimiento de consultas
• Diseñar nuevas tablas con las mejores prácticas de esquemas
• Configurar pooling de conexiones para aplicaciones serverless
• Aplicar Row-Level Security con patrones claros y prácticos

Preguntas frecuentes

¿Cuándo debería usar supabase-postgres-best-practices?

Usa esta skill siempre que escribas, revises u optimices consultas Postgres, diseñes esquemas, configures conexiones o implementes políticas de seguridad. Es especialmente útil durante revisiones de código, migraciones de bases de datos y resolución de problemas de rendimiento.

¿Qué diferencia a esta skill de las guías generales de Postgres?

Esta skill está curada por Supabase y prioriza reglas concretas y accionables con ejemplos SQL antes y después, impacto cuantificado en rendimiento y estructura amigable para agentes. Está diseñada para uso práctico en proyectos reales con Postgres y Supabase.

¿Cómo encuentro las mejores prácticas más relevantes para mi caso?

Comienza con SKILL.md para ver todas las categorías y prioridades. Para temas específicos, explora la carpeta references/ o consulta AGENTS.md para una lista navegable. Cada referencia incluye títulos claros y etiquetas para facilitar su descubrimiento.

¿Puedo contribuir o personalizar la skill?

Sí. Sigue las pautas en references/_contributing.md y README.md para agregar nuevas mejores prácticas o adaptar las existentes a tu entorno. Se incluyen scripts de validación y construcción para control de calidad.

¿Dónde puedo ver ejemplos reales de SQL?

Cada referencia en la carpeta references/ incluye patrones SQL incorrectos y correctos, con explicaciones y enlaces a documentación oficial cuando es relevante.

Para ver el árbol completo de archivos y todas las referencias disponibles, abre la pestaña Archivos en tu agente o navegador de repositorios.