Imported from LoopyLuci/Skills (
skills/scaffold-exercises/SKILL.md). Install upstream withnpx skills add LoopyLuci/Skills --skill scaffold-exercises. Copyright stays with the author.
Scaffold Exercises
Create exercise directory structures that pass linting validation, then 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 subfolder:
problem/- student workspace with TODOssolution/- reference implementationexplainer/- conceptual material, no TODOs
Required files
Each variant folder needs a non-empty readme.md with real content. If the subfolder has code, it also needs a main.ts (>1 line).
Workflow
- Parse the plan - extract section names, exercise names, and variant types
- Create directories with mkdir -p
- Create stub readmes with title and description
- Run lint to validate
- Fix any errors until lint passes
Common Pitfalls
- Empty readme files: Each variant folder's readme.md must have real content. An empty or near-empty readme fails linting.
- Wrong directory naming convention: Sections are XX-section-name, exercises are XX.YY-exercise-name. Wrong naming fails the linter.
- Not running lint after creation: Always run the linter after scaffolding. Fix errors before committing.
Verification Checklist
- Section directories follow XX-section-name convention
- Exercise directories follow XX.YY-exercise-name convention
- Each variant folder has non-empty readme.md
- Code files have main.ts if needed
- Lint passes