scaffold-exercises

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

1|Updated May 7, 2026
One-click install
npx skills add https://github.com/Soham407/studio-kickstart --skill scaffold-exercises-soham407
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-exercises
Source: https://github.com/Soham407/studio-kickstart/tree/main/architecture/matt-pocock-scaffold-exercises
Command: npx skills add https://github.com/Soham407/studio-kickstart --skill scaffold-exercises-soham407

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the repetitive setup work of creating consistent exercise directory structures by generating sections, exercises, and variant folders that are ready for linting and course workflows.

Core Features & Use Cases

  • Scaffolds course exercise structure: Creates exercises/ sections and XX.YY-... exercise directories with required problem/, solution/, and explainer/ (or only the variants you need).
  • Generates valid stubs: Writes non-empty readme.md files (and main.ts when code is required) so the exercises pass linting immediately.
  • Guides renumbering/moving: Provides a safe process for renaming/moving exercises using git-friendly moves and maintaining ordering.

Quick Start

Ask it to scaffold a new course section with exercises, creating explainer/ stubs for each exercise while ensuring lint will pass.

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 so they pass linting automatically?

Scaffolding course exercise directories to pass linting requires generating standardized section and exercise folders with non-empty readme.md stubs. This ensures required subfolders like problem/, solution/, and explainer/ exist immediately for lint-based validation workflows.

What is the standard directory structure for course exercise stubs?

The standard directory structure for course exercise stubs uses XX.YY-... naming conventions for exercises, containing required problem/, solution/, and explainer/ variant subfolders. Each subfolder must contain a non-empty readme.md file to meet course workflow requirements.

How do I create exercise stubs with main.ts for pnpm lint validation?

Creating exercise stubs with main.ts for pnpm lint validation requires scaffolding directories that include code requirement files. The generated main.ts files ensure the pnpm lint command passes immediately without manual file creation or linting errors.

Does pnpm lint work with newly scaffolded course materials without manual fixes?

Yes, pnpm lint works with newly scaffolded course materials because the directory structure generation writes valid stubs. Non-empty readme.md files and required main.ts files are created automatically, ensuring lint passes on the first run.

What's the best way to renumber and move exercises while maintaining directory ordering?

Renumbering and moving exercises while maintaining directory ordering requires a safe process using git-friendly moves. This approach preserves the XX.YY-... exercise naming conventions and ensures the course curriculum structure remains intact during reorganization.

Can I scaffold only specific variant folders like explainer/ instead of all three?

Yes, you can scaffold only specific variant folders like explainer/ instead of generating problem/, solution/, and explainer/ together. The directory structure generation supports creating only the specific exercise variants you need for your course materials.