ProgramaciónPostgres Best Practices (Supabase)
Guía oficial de Supabase con las mejores prácticas de PostgreSQL: cómo diseñar esquemas, crear índices, escribir consultas rápidas, hacer migraciones sin bloquear y proteger los datos con RLS. Cada regla trae ejemplos de SQL mal y bien hechos.
Revisada el 2026-09-21
- Popularidad
- 2.6k
- Licencia
- MIT
- Autor
- Supabase (oficial)
- Categoría
- Programación
Seguridad: revisada
Revisada, sin código malicioso.
¿Qué es?
Es una skill de buenas prácticas de bases de datos PostgreSQL, mantenida por Supabase (empresa oficial de este motor). Contiene 30 reglas organizadas por prioridad, y cada regla trae un ejemplo de SQL incorrecto y su versión correcta.
Piénsalo como el manual del buen fontanero de bases de datos: te enseña los errores que se cometen una y otra vez y cómo hacerlo bien.
Las 8 categorías (por prioridad):
| Prioridad | Categoría | Qué cubre |
|---|---|---|
| 1 | Rendimiento de consultas | Índices que faltan, índices parciales, evitar escaneos completos |
| 2 | Gestión de conexiones | Pooling, escalado, evitar agotar conexiones |
| 3 | Seguridad y RLS | Protección de datos por filas, aislamiento entre usuarios |
| 4 | Diseño de esquemas | Tipos de columnas, estructura de tablas |
| 5 | Concurrencia y bloqueos | Migraciones que bloquean tablas en producción |
| 6 | Patrones de acceso a datos | Cómo consultar bien |
| 7 | Monitorización y diagnóstico | Detectar problemas |
| 8 | Funciones avanzadas | pgvector (búsqueda semántica), pg_cron, colas |
Importante: se carga antes de escribir o cambiar cualquier cosa en una base de datos Postgres. No es solo de rendimiento; también cubre seguridad, esquemas y migraciones.
¿Cuándo me sirve?
Cuando trabajas con una base de datos PostgreSQL:
- "Optimiza esta consulta Postgres" → reglas de rendimiento.
- "Revisa mi esquema por problemas de rendimiento" → diseño de esquemas.
- "Crea una migración que no bloquee la tabla" → concurrencia.
- "Protege los datos por usuario" → RLS (seguridad por filas).
- "Diagnostica esta consulta lenta" → diagnóstico.
¿Esto me sirve a mí?
Sí, y mucho, porque las bases de datos son justo uno de los huecos que te faltaban.
| Si un día piensas... | Te da... |
|---|---|
| "Mi web va lenta por la base de datos" | Reglas de índices y consultas |
| "¿Mi base de datos es segura?" | RLS y buenas prácticas de seguridad |
| "Migré datos y bloqueé la web" | Migraciones sin bloqueos |
| "No sé qué tipo de columna usar" | Diseño de esquemas |
| "Quiero búsqueda semántica (IA)" | pgvector |
No te sirve si no trabajas con bases de datos.
¿Es segura?
Veredicto: ✅ SÍ, es limpia.
- Contenido: son archivos markdown con ejemplos de SQL. No hay scripts ejecutables, ni red, ni instalación.
- Qué hace: da instrucciones y ejemplos a tu IA para que escriba mejor SQL.
- Origen: Supabase, empresa oficial y fiable (gestiona Postgres para cientos de miles de proyectos).
- Nota: el
.mcp.jsondel repo menciona el servidor MCP de Supabase (opcional, para conectar con tu base de datos). Es una herramienta aparte; la skill en sí no necesita nada.
Casos de uso
- Optimizar consultas: índices, índices parciales, evitar escaneos completos.
- Diseñar esquemas: tipos de columna, estructura.
- Migraciones seguras: sin bloquear tablas en producción.
- Seguridad por filas (RLS): que cada usuario vea solo sus datos.
- Diagnóstico: consultas lentas, CPU alta, bloqueos.
- Funciones avanzadas: búsqueda vectorial con pgvector, cron, colas.
Cómo se instala
npx skills add supabase/agent-skills --skill supabase-postgres-best-practicesO como plugin de Claude Code:
/plugin marketplace add supabase/agent-skills
/plugin install postgres-best-practices@supabase-agent-skills¿Dónde funciona?
| CLI | ¿Funciona? | Notas |
|---|---|---|
| OpenCode | ✅ Sí | Vía npx skills add |
| Claude Code | ✅ Sí | Plugin oficial |
| Codex | ✅ Sí | Vía npx skills add |
| Cursor | ✅ Sí | Vía npx skills add |
| GitHub Copilot | ✅ Sí | Formato Agent Skills |
| Gemini CLI | ✅ Sí | Formato Agent Skills |
Es texto puro con el formato estándar Agent Skills: funciona en cualquier asistente.
Enlaces
- Repositorio: https://github.com/supabase/agent-skills
- SKILL.md: https://github.com/supabase/agent-skills/blob/main/skills/supabase-postgres-best-practices/SKILL.md
- Anuncio: https://supabase.com/blog/postgres-best-practices-for-ai-agents