mindmap

🧠 mindmap

An agent skill that turns files, URLs, notes, and topics into interactive mindmaps.

English · 中文

For coding agents that support Agent Skills and the required capabilities. Produces Markmap .md files and optional interactive .html, with concise branches instead of a wall of text.

Two skills: /mindmap (English) and /mindmap-zh (中文).

👀 See it

Open the live interactive demo — zoom and collapse a mindmap generated from a GitHub blog post. No install needed.

More real outputs and source commands: examples.

📦 Install

With Node.js and Git installed:

npx skills add galiacheng/mindmap-skills

Choose your skill and agent. Installation is project-local by default; add --global for all projects.

For plugin marketplace commands, agent-specific installation, and manual setup, see the installation guide.

⚡ Usage

/mindmap report.md
/mindmap https://example.com/article --render
/mindmap "vector databases" --output overview.mindmap.md
/mindmap-zh "向量数据库" --render

You can also pass pasted text or notes directly. Examples use slash-command notation; invoke the skill through your agent's supported mechanism.

Flag	Purpose
--render	Also generate interactive HTML (requires command execution, Bash, and Node.js / npx).
--output <path>	Choose the output path.
--panel	Use a multi-agent judge panel; requires independent subagents, is token-intensive, and is available in mindmap only.

Open the .md at markmap.js.org or with the VS Code Markmap extension; open rendered .html in a browser.

Documentation

Guide	Covers
Installation	Skills CLI, plugin marketplaces, manual setup, skills.sh listing.
Usage and advanced features	Compatibility, input behavior, output format, HTML rendering, judge panel.
Examples	Live mindmaps and their source files.
Contributing	Project structure, implementation, and tests.
Design spec	Original design and rationale.

📄 License

MIT © 2026 Haixia Cheng