skills.rest
MSC72m
MSC72mCOMMUNITY
Explore all skills by this author →
𝕏@MSC72mGitHub

scaffold-exercises

Creates lint-compliant course exercise directories with problem, solution, and explainer subfolders.

Updated Aug 22, 2026
Search Tags:#git#education#scaffold#lint#directory structure#course#exercises
One-click install
npx skills add https://github.com/MSC72m/DevForge --skill scaffold-exercises-msc72m
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scaffold-exercises
Source: https://github.com/MSC72m/DevForge/tree/main/skills/scaffold-exercises
Command: npx skills add https://github.com/MSC72m/DevForge --skill scaffold-exercises-msc72m

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up course exercise structures manually is error-prone: wrong naming conventions, missing readme files, and lint failures from pnpm ai-hero-cli internal lint waste time. This Skill scaffolds exercise directories that pass linting on the first run. ## Core Features & Use Cases - Directory Scaffolding: Creates section folders (XX-section-name/) and exercise folders (XX.YY-exercise-name/) with correct dash-case naming and numeric ordering. - Variant Support: Generates problem/, solution/, and explainer/ subfolders, each with a non-empty readme.md stub that satisfies lint rules. - Lint Validation & Fixes: Runs pnpm ai-hero-cli internal lint and iterates on errors until the structure passes, then commits with git. - Use Case: Given a course plan listing sections and exercises, scaffold the entire exercises/ tree with stub readmes, validate it with the linter, and commit the result in one workflow. ## Quick Start Scaffold the exercises from my course plan into the exercises directory and make sure they pass lint.

Frequently Asked Questions about scaffold-exercises

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold course exercise directories that pass linting?▼

Parse the plan for section and exercise names, create dash-case directories like `exercises/01-section/01.01-exercise/explainer`, add a non-empty readme.md to each variant subfolder, then run `pnpm ai-hero-cli internal lint` and fix any reported errors.

What folder structure does an exercise need to pass ai-hero-cli lint?▼

Each exercise needs at least one of `problem/`, `solution/`, or `explainer/` subfolders, and the primary subfolder must contain a non-empty readme.md with no broken links. Code subfolders also require a main.ts file with more than one line.

How do I rename or renumber exercises without losing git history?▼

Use `git mv` instead of `mv` to rename exercise directories, which preserves git history. Update the numeric prefix to maintain ordering, then re-run the lint command to confirm the moved structure still validates.

Why does exercise linting fail on newly created folders?▼

Lint fails when readme.md files are empty or missing, when `.gitkeep` or `speaker-notes.md` files exist, when readmes contain broken links or `pnpm run exercise` commands, or when no problem, solution, or explainer subfolder exists.

Can I create exercise stubs without writing full content?▼

Yes, a readme-only stub is valid. Create the variant subfolder (default to `explainer/`) with a minimal readme containing just a title and description line, which satisfies the non-empty readme lint rule.

Related Skills

Explore More Education & Research Skills→
pd-phucpd-phuc

scaffold-exercises

Creates exercise directory structures with sections, variants, and readme stubs that pass linting.

Community
Intermediate
Soham407Soham407
1

scaffold-exercises

Generate standardized exercise directory structures with section and exercise naming conventions.

Community
Intermediate
caeziumcaezium
2

scaffold-exercises

Generate exercise directory trees from a course plan with stub subfolders.

Community
Intermediate
kevinnftkevinnft
13

scaffold-exercises

Generate exercise directory trees with sections and variants from a course plan.

Community
Intermediate