module-planner_skill

Overview

This skill converts a concept dependency graph into a sequenced module plan and saves it as outline/module_plan.yml. It produces ordered modules with measurable objectives, mapped concepts, concrete learner outputs, and running-example steps. Use it to turn conceptual structure into teachable units ready for exercise and content generation.

How this skill works

The skill reads outline/concept_graph.yml, topologically sorts concept nodes, and clusters them into coherent modules. For each module it generates 3–6 measurable objectives, lists covered concept node ids, defines concrete outputs learners will produce, and sketches running example steps. Finally it writes outline/module_plan.yml following the recommended schema.

When to use it

• You have an existing outline/concept_graph.yml and need a teaching-ready sequence
• During the tutorial pipeline structure stage (C2) to prepare modules for content generation
• When you need explicit module objectives and outputs for downstream exercise-builder or content-synthesis steps
• Before assigning authors or automating lesson generation to ensure prerequisites are respected

Best practices

• Keep modules focused and cohesive; avoid "misc" buckets
• Target ~5–12 modules for most tutorials; merge overly granular modules with shared prerequisites
• Write objectives as measurable actions so exercise-builder can generate verifiable tasks
• Include at least one concrete output per module (code file, notebook cell, artifact)
• Specify running_example_steps that evolve a single working example across modules

Example use cases

• Convert a research concept DAG into a sequenced course outline with objectives and artifacts
• Prepare module definitions so exercise-builder can attach graded exercises per objective
• Generate a module_plan.yml to drive automated lesson and notebook synthesis tools
• Restructure too-granular concept lists into balanced modules for a short workshop