exercise-builder

WILLOSCAR's avatarfrom WILLOSCAR

Add exercises to each tutorial module (inputs, expected outputs, verification steps) and update `outline/module_plan.yml`.**Trigger**: exercises, practice, verification checklist, 教程练习, 可验证作业.**Use when**: 已有模块计划（`outline/module_plan.yml`），需要为每个模块补齐至少 1 个可验证练习以形成 teaching loop。**Skip if**: 还没有 module plan（先跑 `module-planner`）。**Network**: none.**Guardrail**: 每个练习必须包含 expected output + verification steps；避免只给“思考题”无验收。

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026
[Quizzes and Practice Sets]

When & Why to Use This Skill

The Exercise Builder is a specialized Claude skill designed to enhance educational content by automatically generating verifiable exercises for tutorial modules. It ensures every lesson includes a complete teaching loop by providing clear prompts, expected outputs, and detailed verification checklists, making learning measurable and actionable for students and professionals alike.

Use Cases

  • Technical Course Authoring: Automatically generate hands-on practice labs for software tutorials to ensure learners can verify their progress with concrete outputs.
  • Internal Training Standardization: Update corporate training manuals with 'Definition of Done' checklists and practical exercises to validate employee skill acquisition.
  • Interactive Documentation: Transform static API or product documentation into a series of verifiable tasks that guide users through real-world implementation steps.
nameexercise-builder
description|
**Trigger**exercises, practice, verification checklist, 教程练习, 可验证作业.
**Use when**已有模块计划（`outline/module_plan.yml`），需要为每个模块补齐至少 1 个可验证练习以形成 teaching loop。
**Skip if**还没有 module plan（先跑 `module-planner`）。
**Network**none.
**Guardrail**每个练习必须包含 expected output + verification steps；避免只给“思考题”无验收。

Exercise Builder

Goal: attach at least one verifiable exercise to every module so the tutorial has a teaching loop.

Inputs

  • outline/module_plan.yml

Outputs

  • Updated outline/module_plan.yml

Exercise schema (recommended)

For each module, add an exercises list. Each exercise should contain:

  • prompt
  • expected_output
  • verification_steps (a checklist)

Workflow

  1. Read outline/module_plan.yml and enumerate modules.
  2. For each module, design ≥1 exercise that directly verifies the module objectives.
  3. Ensure every exercise has an expected output and a verification checklist.
  4. Update outline/module_plan.yml in place.

Definition of Done

  • Every module in outline/module_plan.yml has ≥1 exercise.
  • Every exercise includes expected_output + verification_steps.

Troubleshooting

Issue: exercises are open-ended with no verification

Fix:

  • Convert them into “do X → observe Y → verify Z” with concrete artifacts.

Issue: exercises drift from the running example

Fix:

  • Re-anchor each exercise to the module’s running_example_steps so the tutorial stays coherent.