Synthèse automatique
Guide le maintainer d'un workbench existant à travers la création d'une nouvelle skill : justification face aux skills existantes, proposition de nom/description/declencheurs/evals, puis scaffolding et validation par scripts.
Points forts
- Impose une étape d'analyse « reuse before creating » avant toute écriture, avec justification du choix d'une nouvelle skill plutôt qu'une extension
- Cadre la proposition initiale de façon précise : nom jarvis-<workbench>-<verbe-nom>, description en troisième personne avec clause « Does not trigger », phrases de déclenchement vérifiées contre les collisions, 3 scénarios d'eval
- Bloque explicitement l'implémentation jusqu'à approbation humaine, puis exige que ./lint-platform.sh retourne 0 avant de déclarer le travail terminé
- Produit un after-report structuré (fichiers touchés, validation, versioning, impact documentation, entrée éventuelle dans lessons.md)
Limites
- Très dépendant du dépôt shipfoundry : les chemins docs/platform/*, les scripts new-skill.sh, build-dist.sh et lint-platform.sh doivent exister avec cette arborescence
- Suppose que l'utilisateur connaît la taxonomie des classes (foundation / orchestrator / pattern / standalone) et les conventions de nommage de la plateforme
- Ne couvre pas la rédaction initiale d'une skill hors workbench existant ni les étapes de publication au-delà du lint
À utiliser lorsqu'on veut ajouter une nouvelle skill à un workbench shipfoundry existant et qu'on souhaite être guidé de la justification jusqu'à la validation.
À éviter pour modifier une skill existante, créer un workbench from scratch, ou travailler dans un dépôt qui n'applique pas l'operating-model et les scripts de lint shipfoundry.
Analyse de sécurité
PrudenceThe skill operates within a development workflow, using local scripts for scaffolding and validation. No destructive, exfiltrating, or obfuscated actions are present, but the script execution and file modifications warrant caution.
- •Instructs execution of local shell scripts (./new-skill.sh, ./build-dist.sh, ./lint-platform.sh) without declared allowed-tools; these scripts modify repository files and could have side effects if misused.
- •Requires updating CLAUDE.md and documentation, which writes to files.
Exemples
/skill-new notre workbench a besoin d'une skill qui relit les migrations SQL avant merge, déclenchée quand on touche au dossier db/migrate — propose-la moi (justification, nom, description, triggers, evals) avant d'implémenter/skill-new je veux une skill qui génère des fixtures de test à partir d'un schéma Prisma — dis-moi d'abord si ça ne devrait pas être une extension d'une skill existante, puis propose le squelette/skill-new jarvis-api-audit-endpoints — la proposition est approuvée, passe au scaffolding, aux 3 evals, au build et au lint, puis donne-moi l'after-reportdescription: Start a new skill in an existing workbench — platform-owner mode, routed to the new-skill playbook + gates argument-hint: <what the skill does, who triggers it, which workbench>
You are the shipfoundry maintainer — operate per docs/platform/operating-model.md (Type A — new skill).
New skill requested: $ARGUMENTS
Before writing anything:
- Read docs/platform/operating-model.md, docs/platform/new-skill-playbook.md, and docs/platform/skill-taxonomy.md.
- Tell me why this should be a NEW skill and not an extension of the closest existing one (reuse before creating); its class (foundation / orchestrator / pattern / standalone); and where it sits in the platform.
- Propose: the name (jarvis-<workbench>-<verb-noun>), the description (third person, "Use when …" + a "Does not trigger" clause, ≤1024 chars, {braces} not angle brackets), the trigger phrases (verify they don't collide with existing skills), the reference files, and the 3 eval scenarios.
Stop there and get my approval before implementing.
After I approve:
4. Scaffold with ./new-skill.sh <name> <class>, then fill in SKILL.md + the 3 grounded evals.
5. ./build-dist.sh <name> then ./lint-platform.sh <name> — must exit 0.
6. Update CLAUDE.md skill counts + structure tree.
7. Give me the after-report: Summary · Files touched · Validation · Versioning · Documentation impact · whether lessons.md needs an entry. Do not claim done while ./lint-platform.sh is non-zero.
Du fichier au premier essai
Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.
Consulter la source et ses fichiers annexesCe téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.
1. Télécharger le fichier
Télécharger SKILL.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/create-new-skill-in-platform-ms8gxn9q/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.
Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.
mkdir -p '.skill-downloads/create-new-skill-in-platform-ms8gxn9q' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/create-new-skill-in-platform-ms8gxn9q/download' --output '.skill-downloads/create-new-skill-in-platform-ms8gxn9q/SKILL.md.part' && mv '.skill-downloads/create-new-skill-in-platform-ms8gxn9q/SKILL.md.part' '.skill-downloads/create-new-skill-in-platform-ms8gxn9q/SKILL.md'2. Vérifier les prérequis
Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.
Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.
Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.
3. Charger la skill
Le fichier ne fournit pas un en-tête name/description exploitable pour cette procédure native. Le téléchargement reste disponible pour lecture ; utilisez le mode manuel ci-dessous.
Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.
4. Faire un premier essai
Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :
Lis .skill-downloads/create-new-skill-in-platform-ms8gxn9q/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.
Bonnes pratiques React Hook Form
Developpement
Maîtrisez React Hook Form : évitez les anti-patterns, gérez les abonnements, et traitez correctement reset, dirty state et entrées contrôlées.
Migration Emotion vers Mantine
Developpement
Migrer les styled-components Emotion vers des composants Mantine avec style props et modules CSS. Pour convertir .styled.tsx ou supprimer les imports @emotion.
Détecteur de dérive de périmètre
Developpement
Analyse les diffs git par rapport à une intention pour détecter la dérive de périmètre, fichiers non liés et PR trop larges, puis suggère de garder, diviser ou justifier.