Bibliothèque de règles Postgres maintenue officiellement par Supabase : à charger avant que l'agent n'écrive du SQL, crée des tables, modifie des colonnes, rédige des migrations, configure des stratégies RLS, ajoute des index, ou diagnostique des requêtes lentes, l'épuisement des connexions, les verrous et la dilatation des tables. Les règles sont classées en 8 catégories selon leur impact, chaque règle proposant une comparaison entre le SQL incorrect et le SQL correct.
Installations sur skills.sh 468744 (+1162 / 24h)
Audit de sécurité : Non audité
- Pas encore scanné
Justification
- Les catégories 8 sont classées par priorité : les performances des requêtes, la gestion des connexions, la sécurité et le RLS sont marqués CRITICAL, suivis par la conception des tables, la concurrence et les verrous, les modèles d'accès aux données, le diagnostic et la surveillance, et les fonctionnalités avancées ; les fichiers de règles sont placés sous references/ avec des préfixes tels que query-, conn-, security-, etc.
- Le périmètre de déclenchement est très large : le chargement est requis même pour une simple modification de colonne ou l'écriture d'une requête, et couvre pg_cron, les files d'attente pgmq, la recherche vectorielle pgvector et les imports pg_restore
- Chaque règle inclut la raison, des exemples SQL incorrects et corrects, une sortie EXPLAIN optionnelle, et des notes spécifiques à Supabase si nécessaire ; l'auteur précise que cela ne se limite pas à Supabase et que toute instance Postgres fonctionnant n'importe où peut l'utiliser
- Licence MIT, version 1.1.1 ; sur skills.sh, 1162 installations en 24 heures, pour un total de 468744 (représentant uniquement le niveau d'intérêt)
Utilisation
- La commande d'installation s'affichera une fois l'audit validé ; le README propose également une méthode via le plugin Claude Code : claude plugin marketplace add supabase/agent-skills, puis claude plugin install postgres-best-practices@supabase-agent-skills
- Aucun compte Supabase ni service n'est requis ; il s'agit de règles purement textuelles, l'agent lisant à la demande les fichiers de règles individuelles sous references/
Risques
- Non audité pour cette période, classé fixe en niveau C, la commande d'installation n'est pas affichée ; SKILL.md ne contient que du texte et des liens de référence, sans scripts ni requêtes réseau ; les trois audits tiers sur skills.sh sont tous Pass
- Cette revue n'a lu que le tableau général de SKILL.md ; les règles spécifiques sous references/ n'ont pas été lues une par une ; le périmètre de déclenchement est large, tout ce qui touche à Postgres entraîne un chargement, ce qui consomme du contexte
- Les règles proviennent de Supabase, certaines recommandations (pool de connexions, syntaxe RLS) reflètent les habitudes de la plateforme Supabase ; pour un Postgres auto-hébergé, il faut faire preuve de discernement