Obsidian 作者 Steph Ango（kepano）公开的 Agent Skill，教 Agent 正确使用双向链接、属性、嵌入和提示块。适合把会议记录、读书笔记和项目资料整理为结构清楚的本地 Markdown 笔记。它不是云端知识库，也不负责自动抓取你所有文件。
收藏夹越存越多，真正用时却找不到：上周客户提了什么要求？这条结论出自哪次会议？这个 Skill 的价值不是再写一篇摘要，而是让笔记之间形成可追踪的联系。你可以要求它按项目归档、补充标签，把关联文档写成 [[双向链接]]，再将结论、风险和待办分开。
安装：先把前提配齐
本文的命令使用 Skills CLI，只安装指定名称，不一次装入整个仓库。需要 Node.js 22.20.0 或更高版本（当前 CLI 要求）、npm/npx、Git，以及已经可正常使用的 Agent。请先审阅仓库和脚本，再授权执行。
命令末尾的 -a claude-code codex 表示为这两种宿主安装；只用 Claude Code 就保留 -a claude-code，只用 Codex 就保留 -a codex。默认安装在当前项目，不加 -g；只有确实想全局使用时才考虑 -g。安装目录以命令实际输出为准。
- 先准备一个测试文件夹，放入两三份脱敏的 Markdown 笔记；建议用 Obsidian 将该文件夹作为仓库打开，方便预览。不要第一次就授权修改整个私人知识库。
- 在终端进入这个项目目录，运行下面的单技能安装命令。安装的是完整 Skill 目录及 references，不是只复制一个 SKILL.md。
- 在同一项目打开 Agent 新会话，指定可以读取的笔记目录。已有 Obsidian 仓库时，先备份；本例只新增笔记，不移动或删除原文件。
npx skills add kepano/obsidian-skills --skill obsidian-markdown -a claude-code codex使用：从一个小任务开始
- 先让 Agent 阅读指定文件，列出拟定的标题、标签和关联关系，确认它没有把不同项目混在一起。
- 确认后生成整理后的笔记和索引页。原文未写明的负责人、日期、结论，要求标为“待确认”，不要让它自行补齐。
- 用 Obsidian 阅读视图检查属性、提示块和链接；点开几个双链确认目标存在。发现空链接，先核对名称再修正。
这段提示词，可以直接改着用
请使用 obsidian-markdown，整理 notes/inbox 中这3份项目会议笔记。先给我整理计划，确认后在 notes/organized 新建笔记，添加 title、tags、aliases，用 [[双向链接]] 关联同一项目。分别保留事实、决策、待办和待确认信息，并生成一个项目索引页。不要改写原文件，不要杜撰负责人或截止日期。
做到哪一步，才算真正跑通？
你应该得到若干 .md 笔记和一页索引，而不是一个聊天摘要。检查要点是：来源保留、双链可打开、待办可追踪、没有覆盖原始记录。
常见问题：如果 Agent 只在聊天里输出内容，明确要求保存到哪个目录，并确认文件写入权限；如果出现 [[空链接]]，提供真实笔记文件名。安装这个 Skill 不代表同时安装仓库里其他4个 Skill。
边界与费用：它提供的是 Obsidian Markdown 编写规范，不等于全文检索引擎，也不会自动安装 Obsidian 软件或 obsidian-cli。批量读取和写文件由宿主 Agent 执行；使用云端模型时，本地笔记也可能进入模型服务的处理链路。
公开源码：https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown
代码许可：MIT。许可覆盖范围以仓库 LICENSE 为准，第三方服务和素材另行遵守各自条款。
