Scaffold Exercises creates the directory structure for a course: numbered sections, numbered exercises and the problem, solution and explainer subfolders, each with a non-empty readme. It then runs the ai-hero-cli lint and fixes errors until it passes.
It also covers renaming and renumbering exercises with git mv.
What You Get
- Section folders named XX-section-name and exercise folders named XX.YY-exercise-name
- Stub readme files in each variant folder
- A lint run that passes
- A git commit of the result
Common Use Cases
- Stubbing a new course section from an outline
- Adding an exercise with explainer, problem and solution variants
- Renumbering exercises while keeping git history
- Fixing lint errors about empty readmes or stray gitkeep files
What Makes It Unique
It is specific to the ai-hero-cli course format, so it knows the lint rules: gitkeep files and speaker notes are banned, links must resolve and code folders need a main file. It defaults to an explainer stub when the plan is silent.
Under The Hood
The skill is Markdown with shell examples and an agent metadata file for Codex. The agent runs mkdir, writes readme files, runs pnpm ai-hero-cli internal lint, uses git mv for renames and finishes with git commit. All work stays inside the exercises folder of your repository.