How do I install the Mindmap skill?

Run npx skillmds@latest add mrlyk/mindmap in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mindmap safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mindmap?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mindmap free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mindmap?

mrlyk (@mrlyk) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mindmap by mrlyk — Agent Skill

Name: Mindmap
Author: mrlyk

Mindmap

Infrastructure skill: start a local visualization server that renders Mermaid diagrams in the browser. Write .mmd files with pure Mermaid code, and the browser updates in real-time via WebSocket. Use when the user requests a visualization during requirement discussion or planning.

mrlyk 8e79ecf 6 files · 16.5 KB Updated Sep 17, 2026

File contents

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 caller 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'
# 旅行规划 App
## 用户系统
### 注册登录
### 个人偏好
## 行程规划
### 目的地搜索
### 日程安排
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'
# 旅行规划 App
## 用户系统
### 注册登录
### 个人偏好
### 第三方登录
## 行程规划
### 目的地搜索
### 日程安排
### 预算管理
## 社交功能
### 行程分享
### 评论系统
## 技术选型
### React + Zustand
### Node.js API
EOF

When to Use

Calling Skill	Diagram Type	Content
requirement discussion	mindmap	Feature decomposition, scope overview
writing-plans	mindmap or flowchart	Task breakdown tree, sprint structure

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 continue the discussion
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

---name: mindmapdescription: Infrastructure skill: start a local visualization server that renders Mermaid diagrams in the browser. Write .mmd files with pure Mermaid code, and the browser updates in real-time via WebSocket. Use when the user requests a visualization during requirement discussion or planning.---# Mindmap Visualization ServerInfrastructure 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 caller generates Markdown content and writes it to `content_dir/current.mmd`.## Starting the Server```bashbash ${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:```json{"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 ContentWrite 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).```bashcat > "$content_dir/current.mmd" << 'EOF'# 旅行规划 App## 用户系统### 注册登录### 个人偏好## 行程规划### 目的地搜索### 日程安排EOF```## Updating ContentOverwrite the same `current.mmd` file. The browser smoothly re-renders with animation, no reload or flicker.```bashcat > "$content_dir/current.mmd" << 'EOF'# 旅行规划 App## 用户系统### 注册登录### 个人偏好### 第三方登录## 行程规划### 目的地搜索### 日程安排### 预算管理## 社交功能### 行程分享### 评论系统## 技术选型### React + Zustand### Node.js APIEOF```## When to Use| Calling Skill | Diagram Type | Content ||--------------|-------------|---------|| requirement discussion | mindmap | Feature decomposition, scope overview || writing-plans | mindmap or flowchart | Task breakdown tree, sprint structure |## 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 ServerThe server stops automatically on idle. To force stop:```bashbash ${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 continue the discussion- **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

Frequently asked questions