xmind

XMind Mind Map Skill

This skill provides full handling of XMind files (.xmind): parse, create, and update. A companion Python script performs file operations and converts mind map content to Markdown as session-level memory so the user and model can keep iterating.

Tool script

This skill depends on scripts/xmind_tool.py (relative to this skill directory), using only the Python standard library (no third-party dependencies). Run it as:

python skills/xmind/scripts/xmind_tool.py --session <session-id> <command> [args...]

Session management

All commands require --session <id> to isolate memory files per conversation.

How to obtain a session ID (in order):

1. From context: if the thread already has a session ID from a prior use of this skill, reuse it.
2. Otherwise: before the first call, generate a UUID v4 string (e.g. f47ac10b-58cc-4372-a567-0e02b2c3d479) and reuse it on later calls.

• Memory file path: /tmp/skills-xmind-parsed/<session-id>/<filename>.md

Supported formats

Format	Version	Internal layout	Detection
Zen	XMind Zen / 2020+	ZIP containing content.json	Automatic
Legacy	XMind 8	ZIP containing content.xml	Automatic

New files default to Zen; when updating an existing file, keep its original format.

Markdown representation

Parsed Markdown uses an indented list structure, for example:

# Sheet: Sheet title

## Central topic

> Labels: label1, label2
> Link: https://example.com
> Markers: priority-1
> Notes for the central topic

- Branch one  {labels: important}  {link: https://example.com}
  > Notes for branch one
  > Notes can span multiple lines
  - Child 1.1  {markers: task-done, priority-1}
    - Grandchild 1.1.1
  - Child 1.2
- Branch two
  - Child 2.1
  - Child 2.2

Format notes:

• # Sheet: title — sheet title (separate multiple sheets with ---)
• ## title — central topic
• - content — node; two-space indent per level
• {labels: ...} — inline label metadata
• {link: ...} — inline link metadata
• {markers: ...} — inline marker / icon metadata
• > content — node notes (blockquote, directly under the node)
• Central-topic metadata uses top-level blockquotes (> Labels:, > Link:, > Markers:)