Scaffold Exercises (Matt Pocock skill)
Génère l'arborescence d'un exercice pédagogique : sections numérotées `XX-nom`, exercices `XX.YY-nom` en kebab-case, et pour chacun au moins un sous-dossier parmi problem (espace de travail avec des TODO), solution (implémentation de référence) et explainer (matière conceptuelle sans TODO). Chaque sous-dossier reçoit un readme non vide et sans lien mort, plus un main.ts s'il porte du code. Le tout est validé par `pnpm ai-hero-cli internal lint`, puis commité. Périmètre de distribution à connaître : la skill vit dans skills/misc/, dossier absent de plugin.json, donc `claude plugins install mattpocock-skills` ne l'installe PAS, seul l'installeur skills.sh la copie.
Forces
- Convention adossée à un linter : la structure générée est vérifiée par une commande, pas par une relecture humaine
- Trois variantes explicites (problem, solution, explainer) avec une valeur par défaut quand le plan ne tranche pas
- Traite le renommage et le déplacement d'exercices, la partie qui casse toujours une numérotation manuelle
- Bon patron à copier pour toute skill de scaffolding qui doit produire une arborescence conventionnée
Limites
- Couplée en dur à `pnpm ai-hero-cli internal lint` : hors des repos AI Hero, la validation finale ne tourne pas
- Hors plugin : le dossier misc/ n'est pas déclaré dans plugin.json, l'install par plugin ne la fournit pas
- Produit des squelettes vides : le contenu pédagogique reste entièrement à écrire derrière
Pour qui
- Auteurs de cours techniques qui maintiennent un dépôt d'exercices numérotés
- Équipes qui construisent un parcours interne avec problème, solution et explication séparés
- Devs qui cherchent un exemple de skill de scaffolding validée par un linter maison