Writing Skills — TDD for Process Docs
Écrit des skills comme le TDD écrit du code : scénarios de pression avec sous-agents, échec observé, rédaction du doc, conformité observée, refactor des failles
- Quoi
- Écrit des skills comme le TDD écrit du code : scénarios de pression avec sous-agents, échec observé, rédaction du doc, conformité observée, refactor des failles
- Coût
- Gratuit
- Prérequis
- un harness capable de lancer des sous-agents (nécessaire pour les scénarios de pression de base) ; compréhension du skill frère obra-test-driven-development (prérequis exigé).
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — un méta-skill : écrire des skills, C'EST le développement piloté par les tests appliqué à la documentation de processus. La méthode fait tourner le cycle TDD sur la doc : rédiger des scénarios de pression (sous-agents en configuration adverse), les observer échouer (documenter les rationalisations exactes de l'agent), écrire le skill qui traite ces violations précises, observer la conformité des agents, puis refactorer pour boucher les nouvelles failles. Il enseigne aussi la découvrabilité des skills (SDO) : les descriptions doivent énoncer uniquement les conditions de déclenchement — jamais résumer le workflow, sinon les agents suivent la description au lieu de lire le corps — couverture de mots-clés avec messages d'erreur et symptômes, nommage verbe-d'abord, et sobriété en tokens pour les skills chargés souvent. Crédit : @obra. Bémols honnêtes : il exige de comprendre d'abord le skill frère test-driven-development (le SKILL.md l'exige comme PRÉREQUIS) ; c'est un processus lourd — les scénarios de base impliquent de vrais lancements de sous-agents par skill, donc c'est disproportionné pour une checklist unique ; et certaines références (chemins des répertoires de skills, skills compagnons comme using-skills) supposent la disposition superpowers/Claude Code. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage.
Version :
Installation
Prérequis : un harness capable de lancer des sous-agents (nécessaire pour les scénarios de pression de base) ; compréhension du skill frère obra-test-driven-development (prérequis exigé). Installe-moi « Écrire des skills — Obra ». Un méta-skill : écrire des skills comme le TDD appliqué à la documentation de processus, avec un guide de découvrabilité (SDO) — descriptions déclencheurs-seuls, couverture de mots-clés, sobriété en tokens. Dépôt : https://github.com/obra/superpowers/blob/main/skills/writing-skills/SKILL.md 1. Récupère le fichier SKILL.md (et les fichiers auxiliaires) depuis le chemin du dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Contrôle de sécurité : examine le SKILL.md et les scripts pour tout comportement suspect (appels réseau inattendus, commandes shell, récolte d'identifiants). Ce dépôt ne doit contenir aucun secret dans le code, les identifiants passent uniquement par le coffre sécurisé. Vérifie que c'est bien le cas ; ARRÊTE sur le moindre drapeau rouge et dis-le-moi. 3. Installe-le comme skill : copie SKILL.md et ses fichiers auxiliaires dans le répertoire des skills de l'agent, dans un dossier nommé « obra-writing-skills ». 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. GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne l'exige jamais sauf si c'est 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 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.