concept-graph

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 段落。

Stars 377

Forks 25

Install this agent skill to your Project

npx add-skill https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/concept-graph

SKILL.md

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

Output schema (recommended)

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

Read output/TUTORIAL_SPEC.md and extract the concept list implied by objectives + running example.
Normalize each concept into a node with a stable id.
Add prerequisite edges and verify the graph is acyclic.
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)