Serveur & Base de données

Le problème

Claude écrit du SQL qui marche. Le souci, c'est que « qui marche » et « qui tient la charge » sont deux choses différentes. Une requête sans index passe très bien sur 50 lignes de test et met votre site à genoux sur 50 000 lignes réelles. Et sur Supabase, une politique de sécurité (RLS) mal écrite peut diviser les performances par cent sans qu'aucun message d'erreur ne s'affiche.

Ce que fait ce skill

supabase-postgres-best-practices est maintenu par l'équipe Supabase elle-même. C'est un catalogue de règles de performance rangées en 8 catégories, classées par impact :

Priorité	Catégorie	Ce que ça couvre
1	Performance des requêtes	index manquants, index composites, index partiels
2	Connexions	pooling, timeouts, requêtes préparées
3	Sécurité & RLS	politiques d'accès, et leur coût en performance
4	Schéma	types de données, structure des tables
5	Concurrence	verrous, transactions courtes

Chaque règle donne le mauvais exemple, le bon exemple, et l'analyse du plan d'exécution qui explique pourquoi.

Comment s'en servir

Une fois le skill installé, demandez simplement :

Vérifie mes requêtes SQL et mon schéma avec les bonnes pratiques Postgres

Ou, plus ciblé, quand une page rame :

Cette page met 4 secondes à charger. Regarde la requête derrière et dis-moi
ce qui cloche côté base de données.

Claude va chercher la règle concernée dans le catalogue au lieu d'improviser. C'est toute la différence : il ne vous sort pas une réponse générique sur les index, il applique une règle documentée avec un exemple chiffré.

Le cas qui revient le plus souvent

Neuf fois sur dix, le problème est un index manquant sur une colonne utilisée dans un WHERE ou un JOIN. Le symptôme : ça marche vite en développement, ça rame en production. Le skill détecte ce cas en premier parce qu'il est classé priorité 1.

Deuxième cas le plus fréquent sur Supabase : une politique RLS qui refait un SELECT sur une autre table à chaque ligne renvoyée. Le fichier references/security-rls-performance.md de l'archive traite précisément ça.

Le second skill de l'archive

Le skill supabase (sans suffixe) couvre l'usage général de Supabase : authentification, stockage de fichiers, fonctions Edge. À installer si vous utilisez Supabase comme back-end complet et pas seulement comme base de données.

---

Comment installer un skill

Deux options, au choix.

Option 1, le gestionnaire officiel (recommandé)

npx skills add <depot-github>

C'est devenu le standard : la commande va chercher la dernière version chez l'auteur, donc vous n'avez jamais de version périmée. La commande exacte est indiquée plus haut pour ce skill.

Option 2, à la main, depuis cette archive

Copiez le contenu du dossier skills/ de cette archive dans :

• ~/.claude/skills/ pour l'avoir dans tous vos projets
• .claude/skills/ à la racine d'un projet pour l'avoir seulement dans celui-là

Puis relancez Claude Code. Vérifiez avec /doctor que le skill est bien détecté.

---

Ressource vérifiée le 16 août 2026 par Agentic Academy. Un doute, une question ? Posez-la dans la communauté.

D'où ça vient

Ces outils ne sont pas de nous : ils sont publics, et rassemblés ici parce qu'ils marchent. La licence d'origine voyage dans l'archive, comme elle le doit.

Outil	Dépôt	Licence	Installation directe
supabase-postgres-best-practices	supabase/agent-skills	MIT	npx skills add supabase/agent-skills
supabase	supabase/agent-skills	MIT	npx skills add supabase/agent-skills

La commande d'installation est donnée exprès. Une archive téléchargée vieillit ; la commande va chercher la dernière version chez l'auteur. L'archive vous dépanne hors ligne, la commande vous garde à jour.