PhuongDeveloper/landingpage

Prácticas recomendadas de Postgres mantenidas por Supabase, para Postgres ejecutándose en cualquier lugar. Carga este skill ANTES de escribir o cambiar cualquier cosa que viva en una base de datos Postgres: crear o modificar tablas y columnas (incluyendo la elección de tipos de columna), diseño de esquemas, migraciones y archivos de esquema declarativos, políticas RLS y las pruebas que las verifican, índices, disparadores, funciones de base de datos, colas y trabajos programados (pg_cron, pgmq), búsqueda vectorial/semántica (pgvector), y restaurar volcados (pg_restore) o importar datos. También cárgalo al diagnosticar consultas lentas, CPU alta, tiempos de espera, planes EXPLAIN, agotamiento de conexiones, bloqueos, hinchazón o filas visibles para el usuario o inquilino incorrecto. No es solo una guía de rendimiento: las tareas de esquema, migración, seguridad y redacción de SQL también necesitan estas reglas, incluso para un cambio de una sola columna o una sola consulta.

¿Qué es landingpage?

Este skill proporciona un conjunto completo de prácticas recomendadas para Postgres, mantenido por el equipo de Supabase. Está diseñado para guiar a los desarrolladores en la optimización del rendimiento y el diseño de esquemas de bases de datos, cubriendo desde consultas SQL hasta políticas de seguridad a nivel de fila (RLS), índices, migraciones y características avanzadas como pgvector o pg_cron. El skill clasifica las reglas en ocho categorías priorizadas por impacto—desde críticas (rendimiento de consultas, gestión de conexiones, seguridad) hasta baja (funciones avanzadas)—lo que permite identificar rápidamente las acciones más urgentes. Es compatible con cualquier instalación de Postgres, no solo con Supabase, y es esencial tanto para cambios pequeños como para diagnósticos complejos de rendimiento o seguridad.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/PhuongDeveloper/landingpage/tree/HEAD/.agents/skills/supabase-postgres-best-practices

Documentación

Prácticas Recomendadas de Postgres de Supabase

Guía completa de optimización de rendimiento para Postgres, mantenida por Supabase. Contiene reglas organizadas en 8 categorías, priorizadas por impacto para guiar la optimización automatizada de consultas y el diseño de esquemas.

Cuándo Aplicar

Consulta estas pautas cuando:

Escribas consultas SQL o diseñes esquemas
Implementes índices u optimización de consultas
Revises problemas de rendimiento de la base de datos
Configures pooling de conexiones o escalamiento
Optimices características específicas de Postgres
Trabajes con Seguridad a Nivel de Fila (RLS)

Categorías de Reglas por Prioridad

Prioridad	Categoría	Impacto	Prefijo
1	Rendimiento de Consultas	CRÍTICO	`query-`
2	Gestión de Conexiones	CRÍTICO	`conn-`
3	Seguridad y RLS	CRÍTICO	`security-`
4	Diseño de Esquemas	ALTO	`schema-`
5	Concurrencia y Bloqueos	MEDIO-ALTO	`lock-`
6	Patrones de Acceso a Datos	MEDIO	`data-`
7	Monitoreo y Diagnóstico	BAJO-MEDIO	`monitor-`
8	Características Avanzadas	BAJO	`advanced-`

Cómo Usar

Lee los archivos de reglas individuales para explicaciones detalladas y ejemplos SQL:

references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md

Cada archivo de regla contiene:

Breve explicación de por qué es importante
Ejemplo SQL incorrecto con explicación
Ejemplo SQL correcto con explicación
Salida EXPLAIN o métricas opcionales
Contexto adicional y referencias
Notas específicas de Supabase (cuando aplica)