Communitygithub.com

Jo5i4swastaken/Skills-Locker

À utiliser pour toute tâche impliquant Supabase. Déclencheurs : produits Supabase, bibliothèques clientes, intégrations SSR, problèmes d'authentification, CLI/MCP Supabase, modifications de schéma, migrations, audits de sécurité et extensions Postgres.

Qu'est-ce que Skills-Locker ?

Cette compétence fournit un guide complet et à jour pour travailler avec la plateforme Supabase, en mettant l'accent sur les pièges courants, les meilleures pratiques de sécurité et l'utilisation correcte des outils comme la CLI Supabase et le serveur MCP. Elle est conçue pour aider les développeurs à éviter les erreurs fréquentes, notamment en matière de configuration RLS, de gestion des sessions d'authentification et d'exposition des API. La compétence couvre un large éventail de produits Supabase (base de données, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues) et leurs intégrations avec des frameworks comme Next.js, React, SvelteKit, Astro et Remix. Elle insiste sur la nécessité de vérifier la documentation et le changelog de Supabase avant toute implémentation, en raison de leur évolution fréquente, et propose une checklist de sécurité détaillée pour prévenir les vulnérabilités silencieuses. La compétence recommande d'utiliser le serveur MCP Supabase pour la recherche de documentation et l'exécution de requêtes SQL, et fournit des instructions précises pour effectuer des modifications de schéma de manière itérative avant de les valider dans des fichiers de migration.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jo5i4swastaken/Skills-Locker/tree/HEAD/skills/supabase

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Supabase

Principes Fondamentaux

1. Supabase évolue fréquemment — vérifiez le changelog et la documentation actuelle avant d'implémenter. Ne vous fiez pas aux données d'entraînement pour les fonctionnalités de Supabase. Les signatures de fonctions, les paramètres de config.toml et les conventions d'API changent entre les versions.

Commencez par récupérer https://supabase.com/changelog.md (un index récapitulatif léger — pas un chargement lourd), recherchez les balises breaking-change pertinentes pour votre tâche, et suivez la page liée pour celles qui s'appliquent. Consultez ensuite le sujet pertinent en utilisant les méthodes d'accès à la documentation ci-dessous.

2. Vérifiez votre travail. Après avoir implémenté une correction, exécutez une requête de test pour confirmer que le changement fonctionne. Une correction sans vérification est incomplète.

3. Récupérez des erreurs, ne bouclez pas. Si une approche échoue après 2-3 tentatives, arrêtez-vous et réévaluez. Essayez une méthode différente, consultez la documentation, inspectez l'erreur plus attentivement, et examinez les logs pertinents lorsqu'ils sont disponibles. Les problèmes Supabase ne sont pas toujours résolus en réexécutant la même commande, et la réponse ne se trouve pas toujours dans les logs, mais les logs valent souvent la peine d'être vérifiés avant de continuer.

4. Exposition des tables à l'API de données : Selon les paramètres de l'API de données de l'utilisateur, les tables nouvellement créées peuvent ne pas être automatiquement exposées via l'API de données (REST). Si c'est le cas, il faudra explicitement accorder l'accès aux rôles anon et authenticated.

Notez que cela est distinct du RLS, qui contrôle quelles lignes sont visibles une fois qu'une table est accessible, et non si la table est accessible du tout.

Lorsqu'un utilisateur signale qu'une table créée via SQL est soudainement inaccessible, vérifiez ses paramètres d'API de données et si les rôles ont reçu l'accès via une commande GRANT SQL explicite. Lorsque vous accordez un accès public (anon/authenticated), activez toujours le RLS. Voir Exposer une table à l'API de données pour le workflow de configuration complet.

5. RLS dans les schémas exposés. Activez le RLS sur chaque table de tout schéma exposé, ce qui inclut public par défaut. Ceci est critique dans Supabase car les tables dans les schémas exposés peuvent être accessibles via l'API de données lorsque les rôles anon/authenticated ont l'accès (voir Exposer une table à l'API de données). Pour les schémas privés, privilégiez le RLS comme défense en profondeur. Après avoir activé le RLS, créez des politiques qui correspondent au modèle d'accès réel plutôt que de définir par défaut chaque table sur le même modèle auth.uid().

6. Checklist de sécurité. Lorsque vous travaillez sur une tâche Supabase qui touche à l'auth, au RLS, aux vues, au stockage ou aux données utilisateur, parcourez cette checklist. Ce sont des pièges de sécurité spécifiques à Supabase qui créent silencieusement des vulnérabilités :

  • Sécurité des sessions et de l'authentification

    • N'utilisez jamais les revendications user_metadata dans les décisions d'autorisation basées sur JWT. Dans Supabase, raw_user_meta_data est modifiable par l'utilisateur et peut apparaître dans auth.jwt(), il est donc dangereux pour les politiques RLS ou toute autre logique d'autorisation. Stockez les données d'autorisation dans raw_app_meta_data / app_metadata à la place.
    • La suppression d'un utilisateur n'invalide pas les jetons d'accès existants. Déconnectez-vous ou révoquez les sessions d'abord, gardez une durée de validité JWT courte pour les applications sensibles, et pour des garanties strictes, validez session_id par rapport à auth.sessions lors d'opérations sensibles.
    • Si vous utilisez app_metadata ou auth.jwt() pour l'autorisation, souvenez-vous que les revendications JWT ne sont pas toujours à jour tant que le jeton de l'utilisateur n'est pas actualisé.
  • Exposition des clés API et des clients

    • N'exposez jamais la service_role ou la clé secrète dans des clients publics. Privilégiez les clés publiable pour le code frontend. Les clés anon héritées sont uniquement pour la compatibilité. Dans Next.js, toute variable d'environnement NEXT_PUBLIC_ est envoyée au navigateur.
  • RLS, vues et code de base de données privilégié

    • Les vues contournent le RLS par défaut. Dans Postgres 15 et supérieur, utilisez CREATE VIEW ... WITH (security_invoker = true). Dans les versions antérieures de Postgres, protégez vos vues en révoquant l'accès aux rôles anon et authenticated, ou en les plaçant dans un schéma non exposé.
    • UPDATE nécessite une politique SELECT. Dans Postgres RLS, un UPDATE doit d'abord SELECT la ligne. Sans politique SELECT, les mises à jour renvoient silencieusement 0 lignes — pas d'erreur, juste aucun changement.
    • auth.role() est déprécié — utilisez plutôt la clause TO. Supabase a déprécié auth.role() en faveur de la spécification directe du rôle cible sur la politique avec TO authenticated ou TO anon. Au-delà de la dépréciation, auth.role() = 'authenticated' échoue silencieusement lorsque les connexions anonymes sont activées, car les utilisateurs anonymes portent le rôle Postgres authenticated et réussissent la vérification indépendamment du fait que l'utilisateur soit réellement connecté.
      -- Déprécié (à ne pas utiliser)
      create policy "example" on table_name for select
      using ( auth.role() = 'authenticated' );
      
    • TO authenticated seul est une authentification sans autorisation (BOLA / IDOR). Utiliser TO authenticated vérifie uniquement le rôle — il ne restreint pas les lignes auxquelles un utilisateur peut accéder. Le modèle correct combine TO authenticated avec un prédicat de propriété dans USING :
      create policy "example" on table_name for select
      to authenticated
      using ( (select auth.uid()) = user_id );
      
    • Les politiques UPDATE nécessitent à la fois USING et WITH CHECK. Sans WITH CHECK, un utilisateur peut réaffecter le user_id d'une ligne à un autre utilisateur :
      create policy "example" on table_name for update
      to authenticated
      using ( (select auth.uid()) = user_id )
      with check ( (select auth.uid()) = user_id );
      
    • Les fonctions SECURITY DEFINER contournent le RLS. Une fonction SECURITY DEFINER s'exécute avec les privilèges de son créateur — généralement un rôle avec bypassrls (par exemple, postgres). N'ajoutez jamais SECURITY DEFINER pour résoudre une erreur de permission ; cela supprime silencieusement le contrôle d'accès sans corriger la cause sous-jacente. Préférez SECURITY INVOKER.
    • Les fonctions SECURITY DEFINER dans public sont appelables par tous les rôles. Postgres accorde EXECUTE à PUBLIC par défaut pour chaque nouvelle fonction, donc toute fonction SECURITY DEFINER dans public est un point d'accès API public appelable par anon et authenticated (qui héritent de PUBLIC) sans aucun octroi supplémentaire. Lorsque SECURITY DEFINER est réellement nécessaire (par exemple, contourner le RLS sur une table de recherche interne), conservez la fonction dans un schéma non exposé, incluez toujours une vérification auth.uid() dans le corps de la fonction, et exécutez supabase db advisors après les modifications.
  • Contrôle d'accès au stockage

    • L'upsert de stockage nécessite INSERT + SELECT + UPDATE. Accorder uniquement INSERT permet les nouveaux téléchargements mais le remplacement de fichier (upsert) échoue silencieusement. Vous avez besoin des trois.

Pour toute préoccupation de sécurité non couverte ci-dessus, récupérez l'index de sécurité produit Supabase : https://supabase.com/docs/guides/security/product-security.md

CLI Supabase

Découvrez toujours les commandes via --help — ne devinez jamais. La structure CLI change entre les versions.

supabase --help                    # Toutes les commandes de haut niveau
supabase <groupe> --help            # Sous-commandes (ex. supabase db --help)
supabase <groupe> <commande> --help  # Flags pour une commande spécifique

Pièges connus de la CLI Supabase :

  • supabase db query nécessite CLI v2.79.0+ → utilisez MCP execute_sql ou psql comme solution de repli
  • supabase db advisors nécessite CLI v2.81.3+ → utilisez MCP get_advisors comme solution de repli
  • Lorsque vous avez besoin d'un nouveau fichier SQL de migration, créez-le toujours avec supabase migration new <nom> en premier. N'inventez jamais un nom de fichier de migration et ne vous fiez pas à la mémoire pour le format attendu.

Vérification et mise à jour de version : Exécutez supabase --version pour vérifier. Pour les changelogs CLI et les fonctionnalités spécifiques aux versions, consultez la documentation CLI ou les versions GitHub.

Serveur MCP Supabase

Pour les instructions de configuration, l'URL du serveur et la configuration, consultez le guide de configuration MCP.

Dépannage des problèmes de connexion — suivez ces étapes dans l'ordre :

  1. Vérifiez si le serveur est joignable : curl -so /dev/null -w "%{http_code}" https://mcp.supabase.com/mcp Un 401 est attendu (pas de jeton) et signifie que le serveur est opérationnel. Un dépassement de délai ou "connexion refusée" signifie qu'il peut être indisponible.

  2. Vérifiez la configuration .mcp.json : Assurez-vous que la racine du projet contient un .mcp.json valide avec la bonne URL du serveur. Si manquant, créez-en un pointant vers https://mcp.supabase.com/mcp.

  3. Authentifiez le serveur MCP : Si le serveur est joignable et que .mcp.json est correct mais que les outils ne sont pas visibles, l'utilisateur doit s'authentifier. Le serveur MCP Supabase utilise OAuth 2.1 — dites à l'utilisateur de déclencher le flux d'authentification dans son agent, de le terminer dans le navigateur et de recharger la session.

Documentation Supabase

Avant d'implémenter une fonctionnalité Supabase, trouvez la documentation pertinente. Utilisez ces méthodes par ordre de priorité :

  1. Outil MCP search_docs (préféré — renvoie directement des extraits pertinents)
  2. Récupérez les pages de documentation au format markdown — toute page de documentation peut être récupérée en ajoutant .md au chemin de l'URL.
  3. Recherche web pour les sujets spécifiques à Supabase lorsque vous ne savez pas quelle page consulter.

Effectuer et Valider les Modifications de Schéma

Pour effectuer des modifications de schéma, utilisez execute_sql (MCP) ou supabase db query (CLI). Ceux-ci exécutent du SQL directement sur la base de données sans créer d'entrées d'historique de migration, vous pouvez donc itérer librement et générer une migration propre lorsque vous êtes prêt.

N'utilisez PAS apply_migration pour modifier un schéma de base de données local — cela écrit une entrée d'historique de migration à chaque appel, ce qui signifie que vous ne pouvez pas itérer, et que supabase db diff / supabase db pull produira des diffs vides ou conflictuels. Si vous l'utilisez, vous serez bloqué avec le SQL que vous avez passé lors du premier essai.

Lorsque vous êtes prêt à valider vos modifications dans un fichier de migration :

  1. Exécutez les conseillers → supabase db advisors (CLI v2.81.3+) ou MCP get_advisors. Corrigez tout problème.
  2. Consultez la checklist de sécurité ci-dessus si vos modifications impliquent des vues, des fonctions, des déclencheurs ou du stockage.
  3. Générez la migration → supabase db pull <nom-descriptif> --local --yes
  4. Vérifiez → supabase migration list --local

Guides de Référence

  • Retour sur la compétence → references/skill-feedback.md À LIRE OBLIGATOIREMENT lorsque l'utilisateur signale que cette compétence a donné des conseils incorrects ou manque d'informations.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Jo5i4swastaken/Skills-Locker

Implements the "100% Retrieval Strategy" by Vercel. Injects a compressed docs index into AGENTS.md/CLAUDE.md to guarantee the agent always uses your global skills and best practices.

Jo5i4swastaken/Skills-Locker

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Jo5i4swastaken/Skills-Locker

Rewrite text to make ideas and sentences clearer and easier to understand. Use when the user wants to simplify prose, untangle a tangled sentence, reduce jargon, sharpen vague claims, or make writing accessible to a wider audience. Works on any text: docs, emails, blog posts, reports, marketing copy, slide bullets, academic prose. TRIGGER on phrases like: "make this clearer", "clarify this", "simplify this", "rewrite for clarity", "plain language", "reduce jargon", "make it easier to understand", "untangle this", "explain this simply", "tighten this up", "make this readable". Returns the rewritten text only — no diff, no commentary.

Jo5i4swastaken/Skills-Locker

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Jo5i4swastaken/Skills-Locker

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

Jo5i4swastaken/Skills-Locker

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Jo5i4swastaken/Skills-Locker

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

Jo5i4swastaken/Skills-Locker

Agent Media OS — resolve any media need (BGM, SFX, image, icon) into a frozen local file + ledger record. One verb (`resolve`) handles the full cascade — project cache, global cache, HeyGen catalog search, freeze, register. Keeps search noise on disk, hands the agent a path. Use when a composition needs background music, sound effects, images, or icons.

Jo5i4swastaken/Skills-Locker

Author a HyperFrames slideshow composition — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching sequences, and hotspot navigation. Use as an intent check when the user asks for a presentation, pitch deck, slide deck, interactive deck, or page-to-deck conversion that might be a slideshow; if the user did not explicitly ask for a slideshow / slide show, confirm before authoring.

Jo5i4swastaken/Skills-Locker

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.

Jo5i4swastaken/Skills-Locker

Watch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.

Skills associés