Adopt a typed spec for your hand-written CLAUDE.md
Démarrer un CLAUDE.md.spec.ts typé depuis vos instructions manuscrites existantes — fidèle, non destructif, réversible, et jamais un upgrade déguisé
- Quoi
- Démarrer un CLAUDE.md.spec.ts typé depuis vos instructions manuscrites existantes — fidèle, non destructif, réversible, et jamais un upgrade déguisé
- Coût
- Gratuit
- Prérequis
- node/npm et un CLAUDE.md ou AGENTS.md manuscrit que vous voulez typer (installer vigiles d'abord avec npm install -D vigiles) — le skill est un guide que l'agent suit, pas un logiciel à installer
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — le skill adopt-spec de @zernie pour l'outillage vigiles : adopter un .spec.ts typé pour un CLAUDE.md manuscrit existant (ou AGENTS.md) — en partant du fichier que vous avez déjà, de façon non destructive. Les règles d'adoption sont non négociables : fidélité (préserver chaque règle, commande, fichier clé et section de prose tels quels — la spec doit recompiler vers ~votre fichier existant), non-destructif (ne jamais éditer l'original ; écrire seulement le nouveau .spec.ts ; passer au mode spec-managed est une étape explicite séparée), ne pas escalader l'application (garder guidance() comme guidance() — passer à enforce() est le skill séparé strengthen), réversible (vigiles eject rend le fichier en markdown simple à tout moment), et demander avant d'écrire (présenter la spec générée et le résumé d'abord ; écrire seulement sur oui). Le workflow : lire le fichier existant (et vérifier que vigiles est installé — suggérer npm install -D vigiles sinon), analyser la structure (commandes, fichiers clés, règles avec annotations **Enforced by:** ou **Guidance only**, prose), classifier chaque règle (backée par un linter → enforce("linter/rule"), backée par code review → guidance(), non annotée → TODO), générer le fichier de spec (claude({sections, keyFiles, commands, rules}) avec refs file()/cmd()/ref() activant la détection de références périmées), vérifier qu'il compile (npx vigiles compile et comparer avec l'original), présenter le résultat (comptes de conversion, commandes compile/lint, demander l'autorisation d'écrire), optionnellement configurer le CI (étapes GitHub Actions ou l'action zernie/vigiles@v1). Bémols honnêtes : disable-model-invocation est défini dans le frontmatter — ce skill ne tourne que si vous le demandez directement ; la spec n'est aussi bonne que le CLAUDE.md de départ ; le compile-then-compare est le contrôle d'honnêteté que la spec est restée fidèle. Licence MIT. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage. Découvert via skills.sh.
Version :
Installation
Prérequis : node/npm et un CLAUDE.md ou AGENTS.md manuscrit que vous voulez typer (installer vigiles d'abord avec npm install -D vigiles) — le skill est un guide que l'agent suit, pas un logiciel à installer Installe-moi « Adopter une spec typée pour votre CLAUDE.md manuscrit ». Il donne à mon agent le skill adopt-spec de @zernie pour vigiles : lire le fichier d'instructions existant, analyser sa structure (commandes, fichiers clés, règles, prose), classifier chaque règle (enforce/guidance/TODO), générer le CLAUDE.md.spec.ts typé (sans jamais toucher l'original), vérifier qu'il compile et correspond à l'original, présenter le résultat pour approbation, et optionnellement configurer le CI. Licence MIT. Dépôt : https://github.com/zernie/vigiles/blob/main/skills/adopt-spec/SKILL.md 1. Récupère le fichier SKILL.md (et les fichiers d'aide éventuels) depuis le chemin du dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Vérification de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, collecte d'identifiants). Ce dépôt ne devrait contenir aucun secret en dur, les identifiants uniquement via le coffre sécurisé, les hôtes autorisés déclarés dans le SKILL.md. Vérifie que c'est bien le cas ici ; STOP sur tout signal d'alerte et dis-le-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers d'aide dans le répertoire des skills de l'agent, dans un dossier nommé « adopt-spec ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (p. ex. npm install -D vigiles dans le projet cible ; demander à l'agent d'adopter votre CLAUDE.md — il présente la spec avant d'écrire quoi que ce soit). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.
Questions
Comment installer une création ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe la création pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours une création avant de l’installer.