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 段落。
Packaged view
This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.
Install command
npx @skill-hub/cli install willoscar-research-units-pipeline-skills-concept-graph
Repository
Skill path: .codex/skills/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 段落。
Open repositoryBest for
Primary workflow: Ship Full Stack.
Technical facets: Full Stack.
Target audience: everyone.
License: Unknown.
Original source
Catalog source: SkillHub Club.
Repository owner: WILLOSCAR.
This is still a mirrored public skill entry. Review the repository before installing into production workflows.
What it helps with
- Install concept-graph into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
- Review https://github.com/WILLOSCAR/research-units-pipeline-skills before adding concept-graph to shared team environments
- Use concept-graph for development workflows
Works across
Favorites: 0.
Sub-skills: 0.
Aggregator: No.
Original source / Raw SKILL.md
---
name: concept-graph
description: |
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 段落。
---
# 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
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.