mcpField
E
exercise-builder

exercise-builder

github.com/willoscarProductivity51745 installsUpdated 4w ago
Repository

About exercise-builder

exercise-builder is a tutorial-writing skill that adds verifiable exercises to each module in an existing module plan. It fills in prompts, expected outputs, and verification steps.

Key features

  1. 01Adds exercises to planned modules
  2. 02Includes expected outputs
  3. 03Defines verification steps
  4. 04Updates the module plan in place

Use cases

  1. 01Adding practice to tutorial modules
  2. 02Making module exercises objectively checkable

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill exercise-builder

After installing, type/exercise-builderin Claude Code to confirm it loaded.

Bundled filesscripts/run.py

Details

From the project README

Exercise Builder

Triggers & routing

  • Trigger: exercises, practice, verification checklist, 教程练习, 可验证作业.
  • Use when: tutorial 的 C2，已有 outline/module_plan.yml，需要为每个模块补齐 exercise / expected output / verification steps。
  • Skip if: 还没有 module plan。
  • Network: none.
  • Guardrail: 练习必须可验证，不能只给开放式思考题。

Adds the minimal deterministic exercise contract to each planned tutorial module.

Input

  • outline/module_plan.yml

Output

  • updated outline/module_plan.yml

Contract

Each module must end up with at least one exercise containing:

  • prompt
  • expected_output
  • verification_steps

Script boundary

scripts/run.py should:

  • load the current module plan
  • fill missing exercises deterministically
  • write the plan back in place

Keep exercise phrasing logic in shared tutorial tooling rather than hardcoding it repeatedly in the skill script.

Acceptance

  • every module has exercises
  • every exercise includes expected_output
  • every exercise includes verification_steps

Non-goals

  • source coverage auditing
  • prose tutorial writing

Comments

Markdown supported