obsidian-vault
作者 mattpocockobsidian-vault 可帮助你使用 Title Case 文件名、[[wikilinks]] 和索引笔记来搜索、创建并关联 Obsidian 笔记。它适用于在知识库工作流中，链接关系和笔记结构比文件夹更重要的 obsidian-vault 场景。
该 skill 的评分为 71/100，属于值得收录的类型，但建议附带说明：它为在 Obsidian vault 中工作的 agent 提供了可用且具体的流程，不过实现指引相对窄，且主要基于文件路径。对于目录用户来说，它能减少笔记搜索、创建和链接任务中的猜测成本，但可能覆盖不到更广泛的 vault 管理场景。
- 针对 Obsidian 中的搜索、创建和整理笔记任务，触发语清晰。
- 明确记录了 vault 约定，包括 Title Case、扁平化根目录结构、wikilinks 和索引笔记。
- 提供了用于文件名/内容搜索和反向链接发现的直接 shell 命令，有助于提高 agent 执行效果。
- 指导内容只适用于一个硬编码的 vault 路径，因此迁移到其他 vault 的可移植性有限。
- 未提供安装命令、配套文件或更深入的工作流规则，因此 agent 仍可能需要一定的人工解读。
obsidian-vault 技能概览
obsidian-vault 的作用
obsidian-vault 技能帮助你在 Obsidian vault 内，按照 vault 自身的约定来搜索、创建和关联笔记：Title Case 文件名、[[wikilinks]] 以及索引笔记。它最适合需要在现有知识库中工作、又不能破坏其结构的 agent 或用户。
适合哪些人使用
如果你的工作是查找相关笔记、添加一篇符合 vault 风格的新笔记，或者把某个主题映射到索引笔记里，就应该使用 obsidian-vault 技能。它尤其适合基于 Obsidian 的研究系统，特别是 obsidian-vault for Knowledge Bases 这类以链接关系比文件夹层级更重要的流程。
它有什么不同
这个技能不是一个通用的“做笔记”提示词。它编码了 vault 级别的规则：以扁平存储为主、不依赖文件夹组织、索引笔记作为人工精选的链接列表。这样一来，助手在放置笔记、命名笔记或建立正确关联时，就不必靠猜。
如何使用 obsidian-vault 技能
obsidian-vault 的安装与设置
使用 npx skills add mattpocock/skills --skill obsidian-vault 安装。安装后，先确认该技能期望的 vault 路径：/mnt/d/Obsidian Vault/AI Research/。如果你的环境使用的是其他路径，要先在工作流里更新它，再请求文件操作，避免 agent 去错误目录里搜索。
提示词里要提供什么
为了获得更好的 obsidian-vault usage，请明确告诉 agent：笔记目标、目标术语，以及你要执行的动作——搜索、创建还是链接。比如：“查找关于 prompt evaluation 的现有笔记，找出最合适的索引笔记，并起草一篇使用 Title Case 命名、带有相关条目 wikilinks 的新笔记。” 这比“帮我整理笔记”更有效，因为它说明了技能该做什么，以及什么才算完成。
优先阅读哪些文件和路径
先看 SKILL.md 来了解 vault 规则，再检查与你主题相符的笔记标题。这个仓库内容比较稀疏，因此最主要的权威来源就是技能文件本身。对于 vault 工作，最实用的路径是 vault 根目录、索引笔记，以及通过文件名搜索返回的任何笔记名称。如果你需要 backlinks，就在整个 vault 里搜索 [[Note Title]] 这类模式。
能稳定产出的工作流
- 如果你已经知道主题，先按文件名搜索。
- 如果标题不清楚，再按内容搜索。
- 在起草新笔记之前，先打开相关索引笔记。
- 把笔记写成一个完整的知识单元，然后在底部补充相关链接。
- 使用 Title Case，除非 vault 里本来就用了文件夹，否则不要自行引入文件夹结构。
obsidian-vault 技能常见问题
obsidian-vault 只适合 Obsidian 用户吗？
基本上是的。这个技能是围绕 Obsidian 约定设计的，因此在目标系统使用 [[wikilinks]]、索引笔记和精选式 vault 结构时最有用。如果你只需要一份普通的 markdown 草稿，通用写作提示词通常就够了。
什么时候不该用这个技能？
如果内容并不是要放进知识库，或者你需要的是数据库式的任务管理，而不是互相链接的笔记，就不要用 obsidian-vault。当 vault 结构未知、且你无法验证命名或链接规则时，它也不太适合。
它适合新手吗？
适合，只要你能描述清楚主题，并接受结构化输出。真正的学习门槛不在 Obsidian 本身，而在 vault 的约定：Title Case 命名、以链接为先的组织方式，以及通过索引笔记进行导航。这些规则并不复杂，但非常重要。
它和普通提示词相比有什么区别？
普通提示词可能也能生成一篇不错的笔记，但 obsidian-vault 技能加入了能提升匹配度的工作流约束：去哪里搜、笔记怎么命名、以及如何与已有条目连接起来。对于 obsidian-vault for Knowledge Bases 这类把一致性也算进交付内容的工作，这会更有用。
如何改进 obsidian-vault 技能
给这个技能更明确的笔记意图
输入越强，产出的笔记越稳。不要只说“做一个索引笔记”，而是说“为 RAG evaluation 创建一个索引笔记，使用现有相关标题，并且只链接最相关的依赖项”。这样 obsidian-vault 才更容易判断哪些内容该写进笔记，哪些内容应该排除在外。
提供现有笔记范围
质量提升最大的地方，是把附近的笔记、索引笔记或你已经知道的术语告诉它。如果你能给出一个锚点笔记，技能就能推断出合适的链接，并避免重复标题。没有锚点时，它也许能生成技术上正确、但集成度不高的笔记。
初稿完成后检查命名和链接质量
检查标题是否采用了 Title Case，链接是否指向真实存在的笔记标题，以及笔记底部是否包含了正确的依赖项。如果草稿显得很孤立，就要求再修一版：补充 backlinks、合并重复项，或者把标题改成和现有模式一致。