What problem does it solve? Setting up course exercise directories by hand is error-prone: naming conventions, required subfolders, and readme files must all satisfy a strict linter, and mistakes only surface after running validation. This Skill scaffolds the entire structure correctly the first time. ## Core Features & Use Cases - Directory Scaffolding: Creates numbered section folders (XX-section-name) and exercise folders (XX.YY-exercise-name) with dash-case naming inside exercises/. - Variant Stubs: Generates problem/, solution/, and explainer/ subfolders, each with a non-empty readme.md containing a title and description. - Lint Validation & Fixes: Runs pnpm ai-hero-cli internal lint, interprets failures (empty readmes, .gitkeep files, broken links, missing main.ts), and iterates until clean. - Safe Renumbering: Uses git mv to move or renumber exercises while preserving git history, then re-validates. - Use Case: Given a course plan listing sections and exercises, scaffold the full directory tree with stub readmes, pass lint, and commit the result in one workflow. ## Quick Start Scaffold the exercises from my course plan into the exercises directory, create stub readmes for each variant, and run the linter until it passes.
