module-planner

WILLOSCAR's avatarfrom WILLOSCAR

Plan tutorial modules from a concept graph, including module objectives and sequencing, saving as `outline/module_plan.yml`.**Trigger**: module plan, tutorial modules, course outline, 模块规划, module_plan.yml.**Use when**: tutorial pipeline 的结构阶段（C2），已有 `outline/concept_graph.yml`，需要把概念依赖转成可教学的模块序列。**Skip if**: 还没有 concept graph（先跑 `concept-graph`）。**Network**: none.**Guardrail**: 每模块明确 objectives + outputs（最好含 running example 步骤）；避免 prose 段落。

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026
[Lesson Planning]

When & Why to Use This Skill

The Module Planner Claude skill is a specialized tool designed to bridge the gap between raw knowledge mapping and structured educational delivery. It automatically transforms complex concept dependency graphs (DAGs) into logically sequenced tutorial modules. By focusing on topological sorting and pedagogical clustering, it ensures that learners encounter prerequisites in the correct order while providing clear, measurable objectives and tangible outputs for every stage of the curriculum.

Use Cases

  • Technical Course Authoring: Automatically convert a complex web of programming concepts into a step-by-step coding tutorial with a logical progression from basics to advanced features.
  • Corporate Training Development: Transform internal technical documentation and concept maps into a structured onboarding program for new engineers, ensuring all prerequisite knowledge is covered.
  • Bootcamp Curriculum Design: Streamline the creation of intensive learning paths by clustering related skills into manageable modules, each with defined learning outcomes and practical project milestones.
namemodule-planner
description|
**Trigger**module plan, tutorial modules, course outline, 模块规划, module_plan.yml.
**Use when**tutorial pipeline 的结构阶段（C2），已有 `outline/concept_graph.yml`，需要把概念依赖转成可教学的模块序列。
**Skip if**还没有 concept graph（先跑 `concept-graph`）。
**Network**none.
**Guardrail**每模块明确 objectives + outputs（最好含 running example 步骤）；避免 prose 段落。

Module Planner

Goal: turn a concept DAG into a teachable module sequence with clear objectives and outputs.

Inputs

  • outline/concept_graph.yml

Outputs

  • outline/module_plan.yml
  • modules: ordered list of modules
    • id, title
    • objectives (3–6 measurable bullets)
    • concepts (node ids from outline/concept_graph.yml)
    • outputs (what the learner produces)
    • running_example_steps (optional but recommended)

Workflow

  1. Read outline/concept_graph.yml and topologically sort concepts.
  2. Cluster concepts into modules (keep module scope coherent; avoid “misc”).
  3. For each module:
    • write measurable objectives
    • define concrete outputs (code/artifact)
    • specify how the running example advances
  4. Write outline/module_plan.yml.

Definition of Done

  • outline/module_plan.yml exists and modules are ordered by prerequisites.
  • Every module has objectives + outputs.
  • Every concept node from outline/concept_graph.yml is covered by at least one module.

Troubleshooting

Issue: modules are too many / too granular

Fix:

  • Merge adjacent modules with shared prerequisites; target ~5–12 modules for most tutorials.

Issue: objectives are not verifiable

Fix:

  • Rewrite objectives so exercise-builder can attach a concrete exercise for each module.