> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Skills Des instructions prêtes à l'emploi qui apprennent à votre agent de codage à faire les tâches supastack courantes comme le kit l'attend. ## Ce que sont les skills supastack embarque des Agent Skills : de courtes instructions centrées sur une tâche que votre agent de codage charge quand un travail correspond. Au lieu de deviner les conventions du kit à chaque prompt, l'agent suit les mêmes étapes pour les fonctionnalités, les paiements, les modifications de base de données et les tests. Les skills suivent le format ouvert Agent Skills : elles fonctionnent donc dans Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI et d'autres agents compatibles. ## Où vivent les skills Les skills vivent dans `.agents/skills/`, un dossier par skill avec un `SKILL.md` dedans. Des copies identiques sont dans `.claude/skills/` pour Claude Code. ## Quels agents les lisent Codex, Cursor, GitHub Copilot, Gemini CLI et OpenCode lisent `.agents/skills/`. Claude Code lit `.claude/skills/`. Votre agent choisit une skill automatiquement quand votre demande correspond à sa description — ou vous la nommez : « use the `database-schema-change` skill ». ## Quels dépôts les livrent Le dépôt all-platforms inclut toutes les skills. Les dépôts web, mobile et desktop incluent les skills qui leur sont propres ; les skills de tests de bout en bout et de CI ne sont livrées qu'avec le dépôt all-platforms. ## Configuration et environnement Des skills pour démarrer, déployer et configurer le kit. - **Configuration de l'environnement local** (`local-environment-setup`) — pour amorcer ou réparer l'environnement local : premier clone, .env absent ou cassé, Postgres, migrations ou ports. - **Déploiement et variables d'environnement** (`deploy-and-env-vars`) — pour déployer, choisir une cible d'hébergement ou ajouter ou modifier une variable d'environnement. - **Ajouter une dépendance** (`adding-a-dependency`) — pour ajouter, mettre à jour, déplacer ou supprimer une dépendance npm, ou quand la CI échoue au contrôle de licence ou d'audit. - **Mettre à niveau depuis upstream** (`upgrading-from-upstream`) — pour intégrer une version plus récente de supastack dans un produit construit dessus. ## Construire des fonctionnalités Des skills pour ajouter de la surface produit sur chaque plateforme. - **Ajouter une fonctionnalité web** (`add-a-web-feature`) — pour une page ou une section produit avec ses données, server actions, navigation et tests. - **Ajouter un endpoint d'API** (`add-an-api-endpoint`) — pour ajouter ou modifier un endpoint public /api/v1, sa documentation OpenAPI ou les scopes de clé API. - **Ajouter un composant d'UI** (`add-a-ui-component`) — pour une section, un bloc, un contrôle de formulaire ou un composant réutilisable qui suit les règles de style du kit. - **Changer le thème ou le style** (`change-the-theme-or-style`) — pour modifier l'apparence du produit : style de design, pack de couleurs, densité, rayon, police ou layout. - **Ajouter une page marketing ou un article** (`add-a-marketing-page-or-blog-post`) — pour ajouter ou modifier une page publique, une page de pricing, une page légale, un article de blog ou un guide de documentation. - **Ajouter un écran mobile** (`add-a-mobile-screen`) — pour ajouter ou modifier un écran dans l'app mobile Expo. - **Ajouter une capacité desktop** (`add-a-desktop-capability`) — pour modifier l'app desktop Tauri : fenêtre, barre d'état, raccourci global ou mises à jour automatiques. - **Ajouter une notification** (`add-a-notification`) — pour une notification in-app, une notification push ou un élément de digest. ## Auth et paiements Des skills pour la connexion, la facturation et les plans. - **Ajouter une méthode d'auth** (`add-an-auth-method`) — pour modifier la connexion : providers sociaux, magic links, codes par email, passkeys ou deux facteurs. - **Ajouter un provider de paiement** (`add-a-payment-provider`) — pour activer un provider de facturation ou écrire un nouvel adaptateur avec checkout, portail client et webhooks. - **Changer les plans et les prix** (`change-plans-and-pricing`) — pour ajouter, renommer ou re-tarifer un plan : prix, essais, seats, entitlements, limites d'usage ou crédits. ## Données et intégrations Des skills pour le schéma, l'IA, les jobs, l'email, le stockage et les traductions. - **Modification du schéma de base** (`database-schema-change`) — pour ajouter ou modifier une table, une colonne, un index ou une relation et générer la migration. - **Ajouter une fonctionnalité IA** (`add-an-ai-feature`) — pour un appel de modèle, un outil de chat ou d'agent, une tâche IA durable, des budgets ou le bring-your-own-key. - **Ajouter un job en arrière-plan** (`add-a-background-job`) — pour du travail qui tourne après une requête, sur timer ou par workspace. - **Ajouter ou modifier un email** (`add-or-edit-an-email`) — pour ajouter ou modifier un email transactionnel ou changer le provider qui l'envoie. - **Utiliser le stockage de fichiers** (`use-file-storage`) — pour des uploads ou des fichiers stockés comme des avatars, logos ou pièces jointes. - **Ajouter des traductions** (`add-translations`) — pour ajouter ou modifier du texte visible, le traduire ou ajouter une locale. ## Qualité et livraison Des skills pour les tests, la vérification, les reviews et la CI. - **Écrire des tests unitaires** (`writing-unit-tests`) — pour écrire ou corriger des tests unitaires ou d'intégration Vitest. - **Écrire des tests e2e** (`writing-e2e-tests`) — pour ajouter ou corriger des tests end-to-end Playwright, en local ou en CI. - **Vérifier les changements** (`verify-changes`) — avant un handoff, un commit ou une pull request, pour choisir et exécuter les bons contrôles. - **Déboguer un run de CI en échec** (`debugging-a-failing-ci-run`) — quand un run GitHub Actions échoue et qu'il faut en trouver et corriger la cause. - **Relire une PR** (`reviewing-a-pr`) — pour relire une pull request ou un diff : exactitude, isolation des workspaces et conventions. ## Ajouter les vôtres Ajoutez un dossier dont le nom correspond au `name` de son frontmatter, avec un `name` et une `description` qui disent quand l'utiliser. Copiez-le aussi dans `.claude/skills/` pour que chaque agent le trouve. ## Suivant [Construire avec un agent de code](https://supastack.dev/fr/docs/web/agents.md)