scaffold-exercises
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
npx skills add stevesolun/ctx --skill scaffold-exercises --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Scaffold Exercises Create exercise directory structures that pass `pnpm ai-hero-cli internal lint`, then commit with `git commit`. ## Directory naming - **Sections**: `XX-section-name/` inside `exercises/` (e.g., `01-retrieval-skill-building`) - **Exercises**: `XX.YY-exercise-name/` inside a section (e.g., `01.03-retrieval-with-bm25`) - Section number = `XX`, exercise number = `XX.YY` - 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 When stubbing, default to `explainer/` unless the plan specifies otherwise. ## Required files Each subfolder (`problem/`, `solution/`, `explainer/`) needs a `readme.md` that: - Is **not empty** (must have real content, even a single title line works) - Has no broken links When stubbing, create a minimal readme with a title and a description: ```md # Exercise Title Description here ``` If the subfolder has code, it also needs a `main.ts` (>1 line). But for stubs, a readme-only exercise is fine. ## Workflow 1. **Parse the plan** - extract section names, ex
- Directory naming
- Exercise variants
- Required files
- Workflow
- Lint rules summary
- Moving/renaming exercises
- Example: stubbing from a plan
git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings
mkdir -p exercises/05-memory-skill-building/05.01-introduction-to-memory/explainer
mkdir -p exercises/05-memory-skill-building/05.02-short-term-memory/{explainer,problem,solution}
mkdir -p exercises/05-memory-skill-building/05.03-long-term-memory/explainerWhat does the scaffold-exercises skill do?
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
How do I install it?
Run `npx skills add stevesolun/ctx --skill scaffold-exercises --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From stevesolun/ctx, a repository with 569 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.