scaffold-exercises

Scaffold course exercise directories with problem, solution, and explainer subfolders.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/ThorStarlord/interface-skills --skill scaffold-exercises-thorstarlord
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-exercises
Source: https://github.com/ThorStarlord/interface-skills/tree/main/skills/scaffold-exercises
Command: npx skills add https://github.com/ThorStarlord/interface-skills --skill scaffold-exercises-thorstarlord

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the friction of repeatedly creating consistent exercise directory structures by hand and then discovering late that they fail the repo’s linting and conventions.

Core Features & Use Cases

  • Exercise section & exercise directory scaffolding: Creates exercises/XX-section-name/ and XX.YY-exercise-name/ folders using predictable dash-case naming.
  • Variant subfolder creation: Generates the required problem/, solution/, and explainer/ (or minimal stubs) per exercise plan, ensuring required readmes exist and are non-empty.
  • Lint-first workflow: Runs pnpm ai-hero-cli internal lint and guides iteration until the generated structure satisfies all checks.

Quick Start

Tell the AI the section and exercise plan (including section names, exercise names, and which variants you want), and ask it to scaffold the directory structure and stub readmes so the repository lint passes.

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 directory structures that pass pnpm lint checks?

To scaffold exercise directory structures that pass lint checks, generate predictable dash-case folders for sections and exercises, including problem, solution, and explainer subfolders with non-empty readme.md files. Run pnpm ai-hero-cli internal lint and iterate until all repository conventions are satisfied.

What is the required directory structure for creating course exercises with problem and solution variants?

The required directory structure for course exercises uses XX-section-name folders containing XX.YY-exercise-name subfolders. Each exercise must contain problem, solution, and explainer subfolders with non-empty readme.md files to satisfy deterministic lint workflows and avoid broken links.

How do I generate exercise stubs from a plan without failing markdown linting?

Generate exercise stubs from a plan by creating the required problem, solution, and explainer subfolders with non-empty readme.md files. Ensure predictable dash-case naming and run pnpm ai-hero-cli internal lint to verify the markdown structure has no broken links before committing.

Why does my course content fail pnpm ai-hero-cli internal lint after manually creating exercise folders?

Course content fails pnpm ai-hero-cli internal lint when manually created exercise folders lack the required problem, solution, and explainer subfolders, contain empty readme.md files, or use incorrect dash-case naming that violates repository conventions and produces broken links.

Can I use this scaffolding approach for new course sections that only need problem and solution variants?

Yes, you can scaffold new course sections with only problem and solution variants. The process generates the required variant subfolders and minimal stubs based on your exercise plan, ensuring the resulting directory layout still satisfies the repository lint workflow.

What's the best way to automate learning module setup so it complies with repo directory structure conventions?

The best way to automate learning module setup is to scaffold the directory structure by generating section and exercise folders with required variant subfolders and non-empty readmes. This ensures consistent layout and repo compliance by passing pnpm ai-hero-cli internal lint.