| name | mindmap |
| description | Infrastructure skill: start a local visualization server that renders Mermaid diagrams in the browser. Write .mmd files with pure Mermaid code, the browser updates in real-time via WebSocket (no page reload). Used by brainstorm, writing-plans, and other skills. |
Mindmap Visualization Server
Infrastructure skill for rendering interactive mindmaps in the browser via Markmap. Write Markdown heading hierarchy to a .mmd file, the server pushes it via WebSocket, the browser renders with Markmap (interactive: fold/unfold, zoom, drag).
This skill is a tool, not a workflow. It starts a server and returns {url, content_dir}. The calling skill (brainstorm, writing-plans, etc.) generates Markdown content and writes it to content_dir/current.mmd.
Starting the Server
bash ${CLAUDE_SKILL_DIR}/scripts/start-server.sh --project-dir "$(pwd)"
If the path above doesn't resolve, the scripts are located relative to this SKILL.md file, under scripts/start-server.sh.
The script outputs JSON on success:
{"type":"server-started","port":52341,"url":"http://localhost:52341","content_dir":".superharness/visualize/12345-1706000000/content"}
Save the url and content_dir from the output. Tell the user to open the URL in their browser.
Pushing Content
Write Markdown heading hierarchy to content_dir/current.mmd. The server detects the change, reads the file, and pushes it via WebSocket. The browser renders it as an interactive mindmap with Markmap (supports fold/unfold, zoom, drag).
cat > "$content_dir/current.mmd" << 'EOF'
EOF
Updating Content
Overwrite the same current.mmd file. The browser smoothly re-renders with animation, no reload or flicker.
cat > "$content_dir/current.mmd" << 'EOF'
EOF
When to Use
| Calling Skill | Diagram Type | Content |
|---|
| brainstorm | mindmap | Feature decomposition, scope overview |
| writing-plans | mindmap or flowchart | Task breakdown tree, sprint structure |
| finishing-a-development-branch | flowchart | Execution path from trace-summary |
Server Lifecycle
- Server runs in the background (macOS/Linux) or foreground (Windows/Codex)
- Auto-shuts down after 5 minutes of no activity
- Content directory:
.superharness/visualize/{session-id}/content/
- Only one file on disk:
current.mmd (overwritten each update)
- No cleanup needed -
.superharness/visualize/ can be gitignored
Stopping the Server
The server stops automatically on idle. To force stop:
bash ${CLAUDE_SKILL_DIR}/scripts/stop-server.sh
Rules
- Always tell the user the URL before pushing content
- Don't block on the server - start it and move on with brainstorming
- Update frequently - overwrite
current.mmd after each clarification round
- Write Markdown heading hierarchy - use
# ## ### #### for nesting levels, no HTML
- Use Chinese for node names - the primary audience is Chinese-speaking developers
- Markmap renders interactively - users can fold/unfold branches, zoom, and drag to explore