{"id":51600987,"url":"https://github.com/galiacheng/mindmap-skills","last_synced_at":"2026-07-11T22:01:39.586Z","repository":{"id":365184028,"uuid":"1270928799","full_name":"galiacheng/mindmap-skills","owner":"galiacheng","description":"Generate an interactive Markmap mindmap from a file, a URL, pasted text, or a topic. Hybrid structuring with optional standalone-HTML rendering.","archived":false,"fork":false,"pushed_at":"2026-07-01T02:31:57.000Z","size":129,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-01T04:22:49.408Z","etag":null,"topics":["ai","claude-code-plugin","github-copilot-plugin","markmap","mindmaps","skills","visualization"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/galiacheng.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-16T07:12:16.000Z","updated_at":"2026-07-01T02:32:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/galiacheng/mindmap-skills","commit_stats":null,"previous_names":["galiacheng/mindmap-skill"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/galiacheng/mindmap-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galiacheng%2Fmindmap-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galiacheng%2Fmindmap-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galiacheng%2Fmindmap-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galiacheng%2Fmindmap-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/galiacheng","download_url":"https://codeload.github.com/galiacheng/mindmap-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galiacheng%2Fmindmap-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35376136,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-11T02:00:05.354Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude-code-plugin","github-copilot-plugin","markmap","mindmaps","skills","visualization"],"created_at":"2026-07-11T22:01:38.545Z","updated_at":"2026-07-11T22:01:39.579Z","avatar_url":"https://github.com/galiacheng.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🧠 mindmap\n\n**Understand anything at a glance — turn a file, a URL, or a topic into a zoomable mindmap without leaving your AI coding agent.**\n\n[English](README.md) · [中文](README.zh.md)\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-22c55e.svg)](LICENSE)\n[![Works with](https://img.shields.io/badge/works%20with-Claude%20Code%20%7C%20GitHub%20Copilot-2563eb)](#-install)\n[![Output](https://img.shields.io/badge/output-Markmap%20.md%20%2B%20.html-f97316)](https://markmap.js.org)\n[![Skills](https://img.shields.io/badge/skills-%2Fmindmap%20%7C%20%2Fmindmap--zh-8b5cf6)](#-install)\n\n\u003c/div\u003e\n\n`mindmap` is a plugin for [Claude Code](https://docs.claude.com/en/docs/claude-code) and [GitHub Copilot](https://docs.github.com/copilot/concepts/agents/copilot-cli). Point it at a dense report, a long article, or just a topic, and it distills the key ideas into a clean, zoomable [Markmap](https://markmap.js.org) mindmap — right from your terminal.\n\n\u003e Two languages in one plugin: `/mindmap` (English) and `/mindmap-zh` (中文).\n\n### From any source to a map — in one command\n\n```mermaid\nflowchart LR\n    IN[\"Input\u003cbr/\u003efile / URL / text / topic\"] --\u003e CL{Classify}\n    CL --\u003e|URL| FE[Fetch page]\n    CL --\u003e|file| RD[Read file]\n    CL --\u003e|prose| TX[Use as text]\n    CL --\u003e|topic| KN[Model knowledge]\n    FE --\u003e ST[\"Build hierarchy\u003cbr/\u003e4-7 branches, depth 3-4\"]\n    RD --\u003e ST\n    TX --\u003e ST\n    KN --\u003e ST\n    ST --\u003e WR[\"Write Markmap .md\"]\n    WR --\u003e RN{--render?}\n    RN --\u003e|yes| HT[\"Standalone .html\"]\n    RN --\u003e|no| MD[\".md deliverable\"]\n```\n\n---\n\n## 👀 See it\n\nOne command turns a long GitHub blog post into a mindmap:\n\n```\n/mindmap https://github.blog/ai-and-ml/how-we-made-github-copilot-cli-more-selective-about-delegation/ --render\n```\n\nA ~1,500-word article becomes a structure you can read in seconds:\n\n```\n# Smarter Subagent Delegation\n├── The Problem\n│   ├── Delegation is powerful but not free\n│   └── Unnecessary handoffs, overlapping searches, waiting\n├── The Approach\n│   ├── Analyze → find the delegation bottleneck\n│   ├── Change → handle focused work directly\n│   └── Validate → offline, then online, then ship\n├── Results\n│   ├── Tool failures per session −23%\n│   └── Wait time −5% P95, no quality regression\n└── What's Next\n```\n\nThat's real output — see [`examples/`](examples/) for the full Markmap `.md` plus the rendered interactive `.html` (open in any browser to zoom and collapse branches).\n\n**▶ [Open the live interactive mindmap](https://galiacheng.github.io/mindmap-skills/examples/copilot-cli-selective-delegation.mindmap.html)** — no install, just click.\n\n---\n\n## ✨ Why use it\n\n- **Grasp dense material fast** — collapse a 3,000-word report into 5–7 branches you can scan at a glance, instead of reading top to bottom.\n- **One command, any source** — a file, a URL, pasted notes, or just a topic. No copy-pasting into a separate web tool.\n- **Stays in your workflow** — runs inside Claude Code / GitHub Copilot; the map lands as a file right next to your work.\n- **Smart structure, not a text dump** — mirrors a structured doc's outline, or distills loose prose into 4–7 concise branches. Nodes are short phrases, not sentences.\n- **Portable, interactive output** — standard Markmap `.md` that opens anywhere, plus an optional standalone `.html` you can share.\n\n**Good for:** skimming research papers and reports · digesting blog posts and docs · outlining a topic before you write · turning meeting notes into a shareable map.\n\n---\n\n## 📦 Install\n\nThe same repo is a valid plugin for **both** Claude Code and GitHub Copilot — they share the plugin/marketplace format.\n\n### Claude Code\n\n```\n/plugin marketplace add https://github.com/galiacheng/mindmap-skills.git\n/plugin install mindmap@mindmap-marketplace\n/reload-plugins\n```\n\n\u003e The explicit `https://` URL avoids an SSH clone. The `galiacheng/mindmap-skills` shorthand also works **if** you have GitHub SSH keys configured; otherwise it fails with `Permission denied (publickey)`.\n\n### GitHub Copilot\n\n```bash\ncopilot plugin marketplace add galiacheng/mindmap-skills\ncopilot plugin install mindmap@mindmap-marketplace\n```\n\nThen run `/mindmap` in your session. On GitHub Copilot the skill uses the same workflow; tool names map automatically (see [`skills/mindmap/references/copilot-tools.md`](skills/mindmap/references/copilot-tools.md)).\n\nThe marketplace manifest lives at [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json).\n\n### Manual (local, no marketplace)\n\nCopy the skill into your project's (or user-level) skills directory:\n\n```bash\n# project-local\nmkdir -p .claude/skills\ncp -r skills/mindmap .claude/skills/\n\n# or user-level (available in every project)\nmkdir -p ~/.claude/skills\ncp -r skills/mindmap ~/.claude/skills/\n```\n\nThen run `/reload-skills` (or restart Claude Code). Confirm with `/help` that `/mindmap` is listed.\n\n---\n\n## ⚡ Usage\n\n```\n/mindmap \u003cinput\u003e [--panel] [--render] [--output \u003cpath\u003e]\n```\n\n| Input | Example | Behavior |\n|---|---|---|\n| **File** | `/mindmap report.md` | Reads the file, mirrors its structure, condenses nodes. Writes `report.mindmap.md`. |\n| **URL** | `/mindmap https://example.com/article` | Fetches the page (WebFetch), maps its content. Writes `\u003cpage-slug\u003e.mindmap.md`. |\n| **Pasted text** | `/mindmap \"notes about X, Y, Z...\"` | Extracts concepts into branches. Writes `\u003ctitle-slug\u003e.mindmap.md`. |\n| **Topic** | `/mindmap \"vector databases\"` | Generates a map from the model's knowledge. Writes `vector-databases.mindmap.md`. |\n\n**Flags**\n\n- `--panel` — design the structure with a multi-agent judge panel; best for complex or important sources (see **The judge panel** below).\n- `--render` — after writing the `.md`, also produce a standalone interactive `.html` (needs Node.js / `npx`).\n- `--output \u003cpath\u003e` — write the `.md` to a specific path instead of the default.\n\n---\n\n## 🧑‍⚖️ The judge panel (`--panel`)\n\nFor complex or high-stakes sources — papers, long reports — add `--panel`. Instead of designing the structure in a single pass, the skill runs a **multi-agent panel**: **3 proposers → 3 judges → 1 synthesizer**. They compete on structure and pick the best format for every node.\n\n```mermaid\nflowchart TB\n    SRC[\"Source content + skill rules\"]\n    subgraph PROPOSE[\"1 - Propose (3 lenses)\"]\n        P1[\"Proposer A\u003cbr/\u003enarrative-first\"]\n        P2[\"Proposer B\u003cbr/\u003edata-first\"]\n        P3[\"Proposer C\u003cbr/\u003eaudience-first\"]\n    end\n    subgraph JUDGE[\"2 - Judge (score 10 dimensions)\"]\n        J1[\"Judge 1\"]\n        J2[\"Judge 2\"]\n        J3[\"Judge 3\"]\n    end\n    subgraph SYNTH[\"3 - Synthesize\"]\n        SY[\"Top proposal = spine\u003cbr/\u003e+ graft judges' best ideas\"]\n    end\n    SRC --\u003e P1 \u0026 P2 \u0026 P3\n    P1 \u0026 P2 \u0026 P3 --\u003e J1 \u0026 J2 \u0026 J3\n    J1 \u0026 J2 \u0026 J3 --\u003e SY\n    SY --\u003e OUT[\"Final Markmap .md\"]\n```\n\n**1 · Propose** — three agents each design a full structure through a different lens:\n\n| Lens | Designs the map around... |\n|---|---|\n| **Narrative-first** | the source's own arc and section order |\n| **Data-first** | the headline numbers and evidence, every metric **bolded** |\n| **Audience-first** | the punchline first, every leaf legible on a slide |\n\nEach proposer also tags every node with a **format** and a **render tier**:\n\n| Format | Tier | Best for |\n|---|---|---|\n| bullet list | `core` | parallel facts |\n| bold inline | `core` | headline metric, emphasis |\n| link | `core` | references, repo, arXiv |\n| table | `rich` | comparisons, benchmark numbers |\n| code block | `rich` | formulas, reward functions, code |\n| checkbox | `rich` | tasks, limitations, checklists |\n\n**2 · Judge** — three judges independently score every proposal 1–5 on **ten dimensions** (branch count, depth, phrasing, legibility, source fidelity, punchline-first, headline numbers, leaf legibility, visual balance, format fit) and name each proposal's single best idea.\n\n**3 · Synthesize** — one agent takes the top-scored proposal as the **spine**, grafts in the best ideas the judges flagged from the other two, and emits the final Markmap `.md`.\n\n\u003e **Cost:** the panel spawns ~7 agents and is token-intensive — reserve it for sources worth the spend. Without `--panel`, the skill does a fast single-pass build. The exact prompts and schemas live in [`skills/mindmap/references/judge-panel.md`](skills/mindmap/references/judge-panel.md).\n\nBoth real examples in [`examples/`](examples/) were generated with `--panel`.\n\n---\n\n## 🗂️ Output format\n\nThe skill writes [Markmap](https://markmap.js.org)-flavored markdown — a single `#` root, `##` branches, and nested bullets:\n\n```markdown\n---\ntitle: Retrieval-Augmented Generation\nmarkmap:\n  colorFreezeLevel: 2\n  maxWidth: 300\n---\n\n# Retrieval-Augmented Generation\n\n## Indexing\n- Chunk documents\n- Embed chunks\n- Store vectors\n\n## Retrieval\n- Embed the query\n- Find nearest chunks\n\n## Generation\n- Inject context into prompt\n```\n\n**Viewing the `.md`:**\n- Paste it at [markmap.js.org](https://markmap.js.org), **or**\n- Open it in VS Code with the [Markmap extension](https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode), **or**\n- Use `--render` to generate an `.html` you can open in any browser.\n\n---\n\n## 🌐 Rendering to HTML\n\n```\n/mindmap \"transformer attention\" --render\n```\n\nThis runs `npx markmap-cli \u003cfile\u003e.md -o \u003cfile\u003e.html --no-open` under the hood (via [`skills/mindmap/scripts/render.sh`](skills/mindmap/scripts/render.sh)).\n\n- **The `.md` is always the guaranteed deliverable.** Rendering is best-effort.\n- If `npx` / Node.js isn't installed, the skill still writes the `.md`, reports that rendering was skipped, and prints the exact command to run manually — nothing is lost.\n\n**Requirement:** [Node.js](https://nodejs.org) (provides `npx`). No global install needed — `npx` fetches `markmap-cli` on demand.\n\n---\n\n## 🛠️ Contributing\n\nCurious how the skill is wired, or want to run the tests? See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the project layout, the prompt-driven design, and the bash test suite.\n\n---\n\n## 📄 License\n\n[MIT](LICENSE) © 2026 Haixia Cheng\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaliacheng%2Fmindmap-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgaliacheng%2Fmindmap-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaliacheng%2Fmindmap-skills/lists"}