Skills

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.