# Study Mindmap

> Mind-map sub-skill (orchestrated by study-assistant; also usable standalone). Use whenever a chapter knowledge-point mind map needs to be generated or refreshed — the user says "思维导图" "知识图谱" "脑图", or any knowledge point's mastery/status changed. Renders knowledge.json into a zero-dependency offline-capable interactive HTML with collapse/expand, drag/zoom, search, and mastery coloring.

- Skill: `2362094903-ops/study-mindmap` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add 2362094903-ops/study-mindmap`
- Raw SKILL.md: https://api.skillmd.com/api/skills/2362094903-ops/study-mindmap/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: 2362094903-ops (https://skillmd.com/u/2362094903-ops)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/2362094903-ops/study-mindmap

---


# Study Mind Map

Render the knowledge tree in `knowledge.json` into an interactive HTML mind map. **Never hand-write the HTML.**

New layout:

```bash
python3 ~/.claude/skills/study-mindmap/scripts/build_mindmap.py \
  <study-dir>/internal/state/knowledge.json --chapter <N>
```

Output: `<study-dir>/internal/mindmaps/chapter-XX.html`. Legacy root `knowledge.json` outputs to legacy `mindmaps/`.

## Preconditions

`knowledge.json` must exist and pass `validate_workspace.py`. This skill renders only; it does not split chapters into points.

Each leaf should be a small teachable/testable unit. A missing formula, law, graph-reading method, or definition is worse than an extra point.

## Features to mention to the learner

- Click nodes to collapse/expand.
- Drag to pan, wheel to zoom.
- Search highlights matches and expands their path.
- Leaf colors: 灰 = 未学, 红 = 薄弱, 黄 = 基本, 浅绿 = 熟练, 绿 = 精通.
- High-importance points show a star.
- Hover shows id, importance, status, mastery, note.

## Regenerate when

- Any point status/mastery/note changes.
- The knowledge list is revised.

Re-running overwrites the file in place. The browser tab only needs refresh.