Scaffold Exercises (Matt Pocock skill)
Generates the directory structure of a teaching exercise: numbered `XX-name` sections, `XX.YY-name` exercises in kebab-case, and for each at least one subfolder among problem (student workspace with TODOs), solution (reference implementation) and explainer (conceptual material, no TODOs). Each subfolder gets a non-empty readme with no broken links, plus a main.ts if it carries code. All of it is validated by `pnpm ai-hero-cli internal lint`, then committed. Distribution scope worth knowing: the skill lives in skills/misc/, a folder absent from plugin.json, so `claude plugins install mattpocock-skills` does NOT install it, only the skills.sh installer copies it.
Strengths
- A linter-backed convention: the generated structure is checked by a command, not a human reread
- Three explicit variants (problem, solution, explainer) with a default when the plan does not decide
- Handles renaming and moving exercises, the part that always breaks manual numbering
- A good pattern to copy for any scaffolding skill that must produce a conventional tree
Limitations
- Hardcoded to `pnpm ai-hero-cli internal lint`: outside AI Hero repos, the final validation does not run
- Outside the plugin: the misc/ folder is not declared in plugin.json, the plugin install does not provide it
- Produces empty skeletons: the teaching content is entirely left to write afterwards
Best for
- Technical course authors maintaining a repo of numbered exercises
- Teams building an internal path with problem, solution and explanation kept separate
- Devs looking for an example of a scaffolding skill validated by an in-house linter