concept-graph

WILLOSCAR's avatarfrom WILLOSCAR

Build a concept graph (nodes + prerequisite edges) from a tutorial spec, saving as `outline/concept_graph.yml`.**Trigger**: concept graph, prerequisite graph, dependency graph, 概念图, 先修关系.**Use when**: tutorial pipeline 的结构阶段（C2），需要把教程知识点拆成可排序的依赖图（在写教程 prose 前）。**Skip if**: 还没有 tutorial spec（例如缺少 `output/TUTORIAL_SPEC.md`）。**Network**: none.**Guardrail**: 只做结构；避免写长 prose 段落。

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

When & Why to Use This Skill

The Concept Graph skill automates the structural planning of educational content by transforming tutorial specifications into a formal Directed Acyclic Graph (DAG). It identifies essential knowledge nodes and maps their prerequisite dependencies, ensuring a logical learning progression and preventing circular dependencies in complex technical documentation or course curricula.

Use Cases

  • Curriculum Design: Automatically generate a prerequisite map from a course syllabus to ensure students master foundational concepts before moving to advanced topics.
  • Technical Documentation Architecture: Organize multi-part software tutorials by mapping out how different modules and API features depend on each other for a coherent user journey.
  • Knowledge Dependency Analysis: Identify and resolve circular dependencies or missing intermediate steps in internal training materials to improve onboarding efficiency.
  • Instructional Design Automation: Convert high-level learning objectives into a structured YAML-based outline that serves as a blueprint for content creators and AI writers.
nameconcept-graph
description|
**Trigger**concept graph, prerequisite graph, dependency graph, 概念图, 先修关系.
**Use when**tutorial pipeline 的结构阶段（C2），需要把教程知识点拆成可排序的依赖图（在写教程 prose 前）。
**Skip if**还没有 tutorial spec（例如缺少 `output/TUTORIAL_SPEC.md`）。
**Network**none.
**Guardrail**只做结构；避免写长 prose 段落。

Concept Graph (prerequisites)

Goal: represent tutorial concepts as a prerequisite DAG so modules can be planned and ordered.

Inputs

  • output/TUTORIAL_SPEC.md

Outputs

  • outline/concept_graph.yml

A minimal, readable YAML schema:

  • nodes: list of {id, title, summary}
  • edges: list of {from, to} meaning from is a prerequisite of to

Constraints:

  • Graph should be acyclic (DAG).
  • Prefer 10–30 nodes for a medium tutorial.

Workflow

  1. Read output/TUTORIAL_SPEC.md and extract the concept list implied by objectives + running example.
  2. Normalize each concept into a node with a stable id.
  3. Add prerequisite edges and verify the graph is acyclic.
  4. Write outline/concept_graph.yml.

Definition of Done

  • outline/concept_graph.yml exists and is a DAG.
  • Nodes cover all learning objectives from output/TUTORIAL_SPEC.md.
  • Node titles are specific (not “misc”).

Troubleshooting

Issue: the graph looks like a linear list

Fix:

  • Add intermediate prerequisites explicitly (e.g., “data model” before “evaluation protocol”).

Issue: cycles appear (A → B → A)

Fix:

  • Split concepts or redefine edges so prerequisites flow in one direction.