skills.rest
Kunj-Sharma03
Kunj-Sharma03COMMUNITY
Explore all skills by this author →
GitHub

scaffold-exercises

Creates lint-compliant course exercise directories with problem, solution, and explainer subfolders.

Updated Aug 11, 2026
Search Tags:#education#readme#scaffold#lint#directory structure#course#exercises
One-click install
npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill scaffold-exercises-kunj-sharma03
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scaffold-exercises
Source: https://github.com/Kunj-Sharma03/agent-contextify/tree/main/skills-main/skills/misc/scaffold-exercises
Command: npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill scaffold-exercises-kunj-sharma03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up course exercise structures manually is error-prone: directories must follow strict naming conventions, each variant folder needs a non-empty readme, and everything must pass the pnpm ai-hero-cli internal lint check. This Skill automates the scaffolding so exercises validate on the first pass. ## Core Features & Use Cases - Directory Scaffolding: Creates section (XX-section-name) and exercise (XX.YY-exercise-name) directories with dash-case naming under exercises/. - Variant Stubs: Generates problem/, solution/, and explainer/ subfolders, each with a minimal non-empty readme.md that satisfies lint rules. - Lint Validation & Fixing: Runs pnpm ai-hero-cli internal lint and iterates on errors until the structure passes, then commits with git. - Use Case: Given a course plan listing sections and exercises, scaffold the entire directory tree with stub readmes, validate it with the linter, and commit the result in one workflow. ## Quick Start Scaffold the exercises from my course plan into the exercises directory, create stub readmes for each variant, and run the lint check until it 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 course exercise directories that pass linting?▼

Parse the plan for section and exercise names, create dash-case directories like exercises/01-section/01.01-exercise/explainer with mkdir -p, add a non-empty readme.md to each variant folder, then run pnpm ai-hero-cli internal lint and fix any reported errors.

What folder structure does an exercise need to pass lint?▼

Each exercise needs at least one of problem/, solution/, or explainer/ subfolders, and the primary subfolder must contain a non-empty readme.md with no broken links. Code-bearing subfolders also need a main.ts file with more than one line.

How do I rename or renumber exercises without losing git history?▼

Use git mv instead of mv to rename exercise directories, which preserves git history. Update the numeric prefix to maintain ordering, then re-run pnpm ai-hero-cli internal lint to confirm the structure still validates.

Why does the exercise lint check fail on my readme files?▼

Lint fails when readme.md files are empty, contain broken links, include pnpm run exercise commands, or when .gitkeep or speaker-notes.md files exist in the tree. Stub readmes only need a title line and short description to pass.

When should I use explainer versus problem and solution folders?▼

Use explainer/ for conceptual material with no TODOs, problem/ for student workspaces containing TODOs, and solution/ for reference implementations. When stubbing without a detailed plan, default to explainer/ since a readme-only exercise is valid.

Related Skills

Explore More Education & Research Skills→
babuallybabually
1

scaffold-exercises

Create lint-safe exercise directory scaffolds with section, exercise, and variant folders.

Community
Intermediate
mmartinsolivmmartinsoliv

scaffold-exercises

Scaffold exercise directory structures with numbered dash-case folders and readme stubs.

Community
Intermediate
simondhallidaysimondhalliday

exercise-reviewer

Review open-ended exercises and model solutions against textbook chapters.

Community
Advanced
Insik-HanInsik-Han
16

scaffold-exercises

Generate section and exercise directories with stub readmes from a parsed plan.

Community
Intermediate