scaffold-exercises

Automates standardized exercise directory and readme creation with lint validation.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/rnaarla/agent_skills --skill scaffold-exercises-rnaarla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-exercises
Source: https://github.com/rnaarla/agent_skills/tree/main/skills/misc/scaffold-exercises
Command: npx skills add https://github.com/rnaarla/agent_skills --skill scaffold-exercises-rnaarla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation of standardized exercise directories and stubs that pass lint checks.

Core Features & Use Cases

  • Parse a plan to extract section names, exercise names, and variant types, then create the corresponding directory structure (sections, exercises, and variants) with explainer/problem/solution subfolders as needed.
  • Ensure each subfolder has a non-empty readme.md and maintain lint compliance by enforcing proper naming, structure, and file presence.
  • Provide git-friendly scaffolding workflows, including the use of git mv for renaming/moving exercises to preserve history and easy reorganization.
  • Support quick stubs that can be expanded later, with guidance on how to replace placeholders with real content when ready.

Quick Start

Run the installer and select scaffold-exercises to generate exercise scaffolds.

Frequently Asked Questions about scaffold-exercises

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

FAQPage Schema
How do I automatically scaffold course exercises that pass lint checks?

Yes, you can reorganize exercises while preserving history by using git mv workflows. The scaffolding process provides git-friendly directory restructuring to move or rename exercises without losing your previous commit history.

How do I structure sections, exercises, and variants for a new course?

Course developers need a structured plan containing section names, exercise names, and variant types. The scaffolding process parses this input plan to automatically generate the required directory tree and corresponding non-empty readme.md files.

Why does my course directory structure fail lint validation?

Directory structures fail lint validation when subfolders lack proper naming, structure, or file presence. Automated scaffolding enforces lint compliance by ensuring each generated subfolder contains a non-empty readme.md file.

Can I use git mv to rename exercises and preserve history?

Yes, you can reorganize exercises while preserving history by using git mv workflows. The scaffolding process provides git-friendly directory restructuring to move or rename exercises without losing your previous commit history.

How do I generate non-empty readme stubs for new exercises?

You can generate readme stubs by running the scaffolding tool to create quick placeholder files for new exercises. These stubs provide guidance on how to replace placeholders with real content when you are ready to expand them.