scaffold-exercises

Create course exercise directories with dash-case naming and lint validation.

1|Updated May 5, 2026

Search Tags:#linting #scaffold #pnpm #directory structure #exercise templates #course authoring #readme stubs

Ready to run

npx skills add https://github.com/yashs33244/my-mac-claude --skill scaffold-exercises-yashs33244

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: scaffold-exercises
Source: https://github.com/yashs33244/my-mac-claude/tree/main/skills/mattpocock/misc/scaffold-exercises
Command: npx skills add https://github.com/yashs33244/my-mac-claude --skill scaffold-exercises-yashs33244

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of repeatedly creating consistent exercise directory structures that conform to a course linter, without tedious manual setup.

Core Features & Use Cases

Exercise scaffolding: Creates exercises/ sections and numbered exercise folders using the repo’s dash-case naming conventions.
Variant structure generation: Sets up required problem/, solution/, and/or explainer/ subfolders with non-empty readme.md files for each variant.
Lint-safe workflow: Guides you to run pnpm ai-hero-cli internal lint and iteratively fix any issues so the scaffolded exercises pass.
Course building use case: Use it when launching a new course section and you want to stub dozens of exercises (with minimal starter content) that are ready for later authoring.

Quick Start

Ask for scaffold stubs for a new course section by specifying the section name, exercise names, and which variants each exercise should include.

Frequently Asked Questions about scaffold-exercises

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

FAQPage Schema

How do I scaffold exercise templates that pass linting rules automatically?▼

To scaffold exercise templates that pass linting, generate a complete directory tree with correct numeric dash-case naming, non-empty readme.md files, and variant subfolders, then validate using pnpm ai-hero-cli internal lint.

What directory structure is required for course authoring exercise variants?▼

Course authoring requires numbered exercise folders using dash-case naming, containing problem, solution, and explainer subfolders, each with a non-empty readme.md file to pass repository lint validation.

How do I create exercise stubs for a new course section quickly?▼

Create exercise stubs by specifying the section name, exercise names, and desired variants to automatically generate the folder hierarchy and readme stubs ready for later content authoring.

Why does my exercise directory fail the pnpm ai-hero-cli internal lint check?▼

Exercise directories fail lint checks when they lack non-empty readme.md files, use incorrect numeric dash-case naming, contain broken links, or miss required problem, solution, and explainer variant subfolders.

Can I generate only solution variants without problem stubs?▼

Yes, you can initialize specific exercise variants individually, generating only the solution subfolder and its readme.md stub without creating the problem or explainer directories.