scaffold-exercises

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

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/caezium/skills --skill scaffold-exercises-caezium
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-exercises
Source: https://github.com/caezium/skills/tree/main/scaffold-exercises
Command: npx skills add https://github.com/caezium/skills --skill scaffold-exercises-caezium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffold Exercises automates the creation of exercise directory trees from a course plan, producing sections, exercises, and variant stubs with ready-to-lint structure.

Core Features & Use Cases

  • Generate nested directories from a plan, including sections (XX-section-name) and exercises (XX.YY-exercise-name) with variant subfolders (problem, solution, explainer).
  • Create non-empty readmes and enforce naming conventions, enabling immediate lint validation and error-free commits.
  • Execute the end-to-end workflow: parse plan -> scaffold -> lint -> fix to deliver a production-ready course skeleton.

Quick Start

Provide a course plan to the tool and it will generate the exercise directories and run lint to ensure quality.

Frequently Asked Questions about scaffold-exercises

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

FAQPage Schema
How do I auto-generate exercise directory trees from a course plan?

To auto-generate exercise directory trees from a course plan, provide the plan to the tool to create sections and exercises with stub subfolders (problem, solution, explainer) and optional assets. The tool then validates the structure via a lint workflow to ensure non-empty readmes and consistent naming.

What is the best way to scaffold course exercises with problem, solution, and explainer stubs?

Scaffolding course exercises with problem, solution, and explainer stubs is best handled by parsing a plan-based curriculum into nested directories. This creates section and exercise folders with non-empty readmes, enforcing naming conventions and enabling immediate lint validation for error-free commits.

How does lint validation work for generated course exercise directories?

Lint validation for generated course exercise directories checks for required readmes, non-empty content, and consistent naming. It runs a lint pass that checks for broken links and no gitkeep files using the pnpm ai-hero-cli internal lint command to ensure a production-ready course skeleton.

Can I use this scaffolding tool for plan-based curricula without external dependencies?

Yes, you can use this scaffolding tool for plan-based curricula without external dependencies. It operates independently to parse your plan, generate the exercise directory tree, and run the lint workflow to fix structural issues and deliver a ready-to-commit course skeleton.

Why does my generated course scaffold fail the lint check for broken links and gitkeep files?

Generated course scaffolds fail lint checks for broken links and gitkeep files if the directory structure is incomplete. The lint workflow validates required readmes, non-empty content, and consistent naming, checking specifically for broken links and gitkeep files using pnpm ai-hero-cli internal lint before allowing commits.