技能包

用 Obsidian 技能编写带双向链接的笔记

适合要让代理按 Obsidian 风格编写 Markdown 的人,前提是使用兼容 Agent Skills 的代理,并只走官方 npx skills add 这一条主路径。

官方来源 · obsidian-skills

安装

npx skills add https://github.com/kepano/obsidian-skills

适合谁

你要让兼容 Agent Skills 的代理,按 Obsidian 风格创建和编辑 Markdown 时,用这组技能。它教代理处理 Obsidian Flavored Markdown,也就是带 .md 的笔记,并使用双向链接、嵌入、标注框、属性以及其他 Obsidian 特有语法。语法说明见

https://help.obsidian.md/obsidian-flavored-markdown

官方仓库是

https://github.com/kepano/obsidian-skills

源文写明这些技能遵循 Agent Skills 规范,因此任何兼容该规范的代理都能用。不要把规范里出现过的几个产品名抄进正文当使用范围,也不要推断只有那几个环境能装。还没有兼容代理、或不准备在本机执行官方安装命令时,先不要继续。

这是给已经有 Obsidian 笔记习惯、想让代理写出能被仓库正确理解的 Markdown 的人。只想让代理写普通 Markdown、又不需要双向链接或属性时,不必走这条技能。规范地址是

https://agentskills.io/specification

3 分钟完成第一次尝试

先确认当前代理能接收 Agent Skills。打开官方仓库核对:

https://github.com/kepano/obsidian-skills

推荐安装只有这一条。装技能会往本机写入技能文件,执行前确认你要留下这组 Obsidian 技能:

npx skills add https://github.com/kepano/obsidian-skills

命令里的地址必须和官方仓库完全一致。成功信号是这条命令正常结束。源文没有写通用的技能落盘目录,不要自行补路径。源文还有面向特定客户端的插件或克隆写法,第一次不要并列成第二条主路径,也不要把市场命令套到未说明如何接收的环境。

第一次在代理里只做核对,不要先改正式笔记库。请代理说明 Obsidian Flavored Markdown 里双向链接、嵌入、标注框和属性分别是什么,以及它准备怎样创建或编辑一个 .md 文件。观察点是它能复述这些语法点,并且还没有写入任何文件。

若你接下来要试一次真正的创建或编辑,先指定一个可丢弃的笔记,并确认这次会改磁盘。源文没有给出仓库路径或文件名样例,不要编造库位置。第一次不要批量改多个文件,也不要发明未出现的 CLI 子命令。

使用案例

案例一:先确认技能已按官方 npx 路径装上。在兼容 Agent Skills 的代理里,确认你接受本机将写入技能文件后,只运行 npx skills add,目标地址为

https://github.com/kepano/obsidian-skills

适合只想把 Obsidian 技能接到代理、还不准备改笔记的人。成功信号是安装命令正常结束,并且代理能说出它会创建和编辑带双向链接、嵌入、标注框和属性的 Markdown。源文没有写安装后的目录树,不要编造文件名。若安装失败,停下,不要改用未选作主路径的插件或克隆命令。

案例二:在可丢弃笔记上试一次创建或编辑。源文写明可以创建和编辑 Obsidian Flavored Markdown,语法包括双向链接、嵌入、标注框和属性。适合已经装好技能、想看代理是否按 Obsidian 语法写 .md 的人。执行前确认目标文件可以丢弃,并且你接受这次会写盘;完成后打开该 .md,检查是否出现上述语法,而不是普通纯文本。源文没有给出具体文件名、库路径或命令行开关,不要编造。也不要把标题里提过、但摘录没写到的其他格式当成已经可执行的步骤。

使用边界

主路径只有 npx skills add,地址必须是

https://github.com/kepano/obsidian-skills

源文另外写过插件市场和克隆到特定客户端目录的装法,那不是第一次尝试的主路径;不要和 npx 并列,也不要推广到未说明的环境。技能遵循 Agent Skills 规范,只适用于兼容该规范的代理,见

https://agentskills.io/specification

能力范围写到创建和编辑 Obsidian Flavored Markdown,以及双向链接、嵌入、标注框、属性和其他 Obsidian 特有语法。帮助页是

https://help.obsidian.md/obsidian-flavored-markdown

证据没有给出具体子命令、库路径或卸载步骤。没有写到的格式名称、CLI 操作和客户端独占结论,不要补全。第一次成功只看安装结束和代理能复述语法,真正写盘前必须先确认目标笔记可以丢弃。证据没有写到卸载、更新或如何从代理里关闭这组技能,不要自行补步骤。若代理开始改正式库里的多篇笔记,先停下来,回到可丢弃的单文件。摘录没有写到的其他格式或命令行操作,不要写成已经可执行的步骤。