skills.rest
tajo9128
tajo9128COMMUNITY
Explore all skills by this author →
Website𝕏@hosting_hydGitHub

scaffold-exercises

Creates lint-compliant exercise directory structures with problem, solution, and explainer subfolders.

2|Updated May 12, 2026
Search Tags:#git#education#linting#scaffolding#readme#directory structure#course exercises
One-click install
npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill scaffold-exercises-tajo9128
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scaffold-exercises
Source: https://github.com/tajo9128/BioDockify-Pharma-AI/tree/main/.agents/skills/scaffold-exercises
Command: npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill scaffold-exercises-tajo9128

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up course exercise directories by hand is error-prone: wrong naming conventions, missing readme files, and lint failures slow down course authoring. This Skill scaffolds section and exercise directories that pass the ai-hero-cli linter on the first run. ## Core Features & Use Cases - Directory Scaffolding: Creates numbered section folders (XX-section-name) and exercise folders (XX.YY-exercise-name) with dash-case naming inside an exercises/ tree. - Variant Support: Generates problem/, solution/, and explainer/ subfolders, each with a non-empty readme.md stub containing a title and description. - Lint Validation Workflow: Runs pnpm ai-hero-cli internal lint, interprets failures (empty readmes, .gitkeep files, broken links, missing main.ts), and iterates until clean. - Safe Renumbering: Uses git mv to rename or renumber exercises while preserving git history, then re-validates. - Use Case: Given a course plan listing sections and exercises, generate the entire stubbed directory tree, validate it with the linter, and commit the result. ## Quick Start Scaffold the exercises from my course plan into the exercises directory and make sure they pass lint.

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?▼

Create numbered section folders like 01-retrieval-skill-building inside exercises/, then add exercise folders like 01.03-retrieval-with-bm25 containing problem, solution, or explainer subfolders. Each subfolder needs a non-empty readme.md, then run pnpm ai-hero-cli internal lint to validate.

What files does each exercise subfolder require?▼

Each problem, solution, or explainer subfolder needs a non-empty readme.md with no broken links. If the subfolder contains code, it also needs a main.ts file with more than one line, but readme-only stubs are acceptable.

Why does the exercise linter reject my directory structure?▼

Common failures include empty readme files, .gitkeep or speaker-notes.md files, broken links in readmes, pnpm run exercise commands in readmes, and missing problem, solution, or explainer subfolders. Fix each reported issue and re-run the lint command.

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

Use git mv instead of mv to rename exercise directories, which preserves version history. Update the numeric prefix to maintain ordering, then re-run the linter to confirm the moved exercises still validate.

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 exercises without a detailed plan, default to explainer-only folders.

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
Soham407Soham407
1

scaffold-exercises

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

Community
Intermediate
ActiveInferenceInstituteActiveInferenceInstitute
13

geo-infer-edu

Generate standards-aligned GIS courses with learning objectives and modules.

Community
Intermediate
redpanda-dataredpanda-data
34

scaffold-exercises

Create exercise directories and README files with naming conventions.

Official
Intermediate