mcpskills.net
SkillsMCPsAgentsPrompts
mcpskills.net — A curated directory of AI agent Skills and MCP servers
TermsPrivacy
← Back to Skills
Misc

Scaffold Exercises

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting.

by Matt PocockRepository →Source →

Scaffold Exercises

Create exercise directory structures that pass linting, then commit with git commit.

Directory naming

  • Sections: XX-section-name/ inside exercises/
  • Exercises: XX.YY-exercise-name/ inside a section
  • Names are dash-case (lowercase, hyphens)

Exercise variants

Each exercise needs at least one of these subfolders:

  • problem/ - student workspace with TODOs
  • solution/ - reference implementation
  • explainer/ - conceptual material, no TODOs

Required files

Each subfolder needs a readme.md that is not empty and has no broken links.

Workflow

  1. Parse the plan - extract section names, exercise names, and variant types
  2. Create directories - mkdir -p for each path
  3. Create stub readmes - one readme.md per variant folder with a title
  4. Run lint - validate
  5. Fix any errors - iterate until lint passes