brain-map-skill 是一个面向智能体友好设计的笔记可视化工具，能够把一个包含 Markdown 笔记的文件夹（例如 Obsidian 仓库或 gbrain 导出）转换为单个自包含的交互式 HTML 知识地图。
主要用途
将分散的 Markdown 笔记整合为直观的力导向图谱，同时提供时间轴以观察知识库随时间的增长过程，并支持点击节点查看详细内容。最终输出为单个 HTML 文件，无需托管知识应用、无需嵌入计算或服务器。
主要能力
- 主题着色：以笔记的顶层文件夹作为主题（Theme），自动从调色板分配颜色给节点和边。若存在 Work/、Study/、Life/ 文件夹则保留其旧版配色，根目录笔记归为 Other。
- 节点形状：根据子文件夹或标签（Type）决定节点形状，涵盖 person、meeting、journal、lecture、project、link、todo、index、note 等类型。
- 边与节点大小：边由解析后的 [[wikilinks]] 生成；节点大小随链接数量缩放，枢纽节点会显示标签。
- 时间轴：基于笔记的 created 时间戳，按月分桶并按主题堆叠。若 frontmatter 中缺少 created，则回退使用文件自身的时间戳，因此普通仓库也能生成时间轴。
- 交互操作：可拖动或播放时间轴（从空到当前逐步显示笔记）；按主题和类型筛选（实时计数）；搜索高亮匹配项；点击节点会淡化其余部分、高亮其邻域并打开详情面板（摘要、标签、日期、相连笔记）；响应式设计，可适配手机。
使用方式
- 零配置体验：仓库内附带预构建演示，包含 992 条虚构笔记（覆盖 work、study、life 三个主题）。直接打开该 HTML 文件即可体验时间轴拖动、播放增长、点击节点和筛选功能，无需生成笔记、嵌入、gbrain 或 Python。
- 从自己的笔记构建：命令为
brain-map-skill <notes_dir> --dir <out>，其中<notes_dir>是 Obsidian 仓库或 gbrain 导出目录。地图读取普通的 Markdown 文件，解析 YAML frontmatter（tags、created）和 [[wikilinks]]。networkx 依赖可选，构建器会自动检测并选择更优路径；无论是否安装 gbrain、嵌入或服务器均可运行。 - 作为智能体技能安装：Cursor 等环境可将 SKILL.md 粘贴到智能体指令中，该文件是自包含的。
- 重新生成演示语料：演示中所有人物、组织和事件均为虚构，不涉及真实数据。
适用场景
适合需要将 Obsidian 仓库或 gbrain 笔记导出为可视化知识地图的用户，尤其适合希望以智能体技能形式集成到 Claude Code、OpenAI Codex、Cursor、Gemini CLI、OpenClaw 等工作流中的场景。交叉链接越丰富（人物卡片、会议参与者、索引页等），地图可读性越高；该工具设计上与 save-note 技能搭配，后者写入的正是这种格式。
限制
资料中未提及收费、价格、平台限制或性能上限等信息，暂未提供。
