企业官网建设流程全解析

如何安装 obsidian-skills：3 条路径让 Obsidian AI 技能跑起来

【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills

你有没有遇到过这种情况：让 AI 帮你写笔记，结果它用的是标准 Markdown，你得反复解释"Obsidian 里双链要写[[ ]]、标注要写> [!note]"？obsidian-skills 就是为了解决这件事而做的技能包：装上之后，你的 AI 会自己使用 Obsidian Flavored Markdown、.base数据库视图、.canvas画布文件，还能通过 Obsidian CLI 直接操作你的库。下面按 3 条路径带你完成安装，并给出立即可做的验证动作，全程大约 5 分钟。

🧩 它能做什么：5 个技能，各有明确用处

• Obsidian Flavored Markdown：创建和编辑.md文件，支持双链、嵌入、标注、frontmatter 属性。省掉你每次向 AI 解释 Obsidian 特有语法的功夫，产出的笔记可直接打开使用
• Obsidian Bases：生成.base文件，写筛选器和公式，做表格、卡片视图。省掉你手写 YAML 和记筛选语法的时间
• JSON Canvas：创建.canvas文件，布置节点、连线和分组。省掉你手写 JSON、逐个核对 ID 的繁琐
• Obsidian CLI：在 Obsidian 打开时，AI 可以读写笔记、搜索库内容，甚至辅助插件和主题开发。省掉你手动打开 Obsidian 点来点去的操作
• Defuddle：从网页提取干净的 Markdown，去掉导航和广告。把文章存进笔记时更省 token、少做清理

三条上手路径

按你的环境选一条即可：

最快路径：Marketplace

在 Claude Code 中依次输入：

/plugin marketplace add kepano/obsidian-skills /plugin install obsidian@obsidian-skills

重启 AI 助手，技能即可用。

命令行路径：npx

终端里执行一条命令：

npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills

工具会自动下载并配置所有技能，装完重启助手即可。

完全掌控路径：手动落盘

先克隆仓库：

git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills

然后按你的工具放好文件：

1. Claude Code：把仓库内容放进你 Obsidian 库根目录的.claude文件夹（或你给 Claude Code 使用的工作目录）
2. Codex：把skills/目录复制到~/.codex/skills/
3. OpenCode：把整个仓库放进~/.opencode/skills/。注意是完整仓库，只复制里面的skills/文件夹会出问题，后面坑位里会讲

OpenCode 会自动发现所有SKILL.md，不需要改任何配置文件，重启后生效。

验证安装是否真的生效

别只问 AI"装好了吗"，直接做下面三件小事：

1. Markdown：让它新建一条笔记，包含一个> [!tip]标注和一个[[双链]]。在 Obsidian 阅读视图打开，标注正常渲染、双链可点击，说明技能已加载
2. 画布：让它生成一个只含 1 个节点的.canvas文件并打开。画布上出现一张卡片即为成功
3. CLI：保持 Obsidian 打开，让它执行obsidian create name="测试笔记" content="hi"。库里根目录出现新笔记，说明 CLI 链路通了

第一条通过就说明技能读进来了，后两条按同一逻辑验证。

⚠️ 大概率会踩的 4 个坑

1. 现象：AI 还是不会 Obsidian 语法。原因：SKILL.md不在工具扫描的路径里，或者只复制了内部的skills/文件夹。解法：核对目录结构。OpenCode 要求~/.opencode/skills/obsidian-skills/skills/<技能名>/SKILL.md，Claude Code 要求内容放在库根目录的.claude下
2. 现象：.base文件打开报 YAML 错误。原因：筛选表达式或公式字符串里的特殊字符引号没配对。解法：检查公式引号，含特殊字符的字符串用单引号包裹，必要时让 AI 按校验步骤自查
3. 现象：CLI 命令报连不上。原因：Obsidian CLI 需要一个正在运行的 Obsidian 实例。解法：先打开 Obsidian，再执行命令
4. 现象：把网页文章转成笔记后内容又长又杂。原因：直接抓了原始 HTML。解法：用defuddle parse <url> --md提取干净的 Markdown

进阶一瞥

两个最有代表性的用法：

• 把笔记变成数据库：让 AI 为某个文件夹生成.base，按标签筛选笔记，加一个公式计算派生字段，再配一个表格视图，散乱的笔记就变成可查询的列表
• 笔记自动化：Obsidian 保持打开时，用 CLI 技能让 AI 批量创建、搜索、整理笔记，配合 Markdown 技能可以"一次写对"，而不是事后手动修语法

技能的具体规则和参考材料在各SKILL.md及其references/子目录中，例如 skills/obsidian-markdown/SKILL.md 和 skills/json-canvas/SKILL.md，对某个语法拿不准时直接翻对应文件。

收尾

挑一条路径执行命令，再完成上面三个验证动作，安装就算真正跑通了。后续建议先用 Markdown 技能熟悉流程，再按需引入 Bases 和 Canvas。

【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills