Skill Obsidian-Skills 为笔记工具接入AI智能体能力的技能包

用 Obsidian 做知识管理的人越来越多，但要把 AI 智能体接进去——比如让 agent 按 Obsidian 风味 Markdown 写笔记、管理 Bases、操作 CLI、批量从数据生成模板——往往要自己拼脚本。obsidian-skills 把这些“笔记 + AI”的标准能力打包成符合 Agent Skills 规范的技能，Claude Code、Codex、OpenCode 都能直接调用。

项目基本信息

一、项目介绍

kepano/obsidian-skills 是一组遵循 Agent Skills 规范、面向 Obsidian 的技能，MIT 协议。它包含 obsidian-markdown（写带 wikilink/embed/callout 的 OFM）、obsidian-bases（视图/筛选/公式）、json-canvas（节点连线画布）、obsidian-cli（插件与主题开发）、defuddle（干净抽取网页 Markdown 省 token）、knap（从 JSON/CSV 批量生成 Markdown 模板）。技能可经 marketplace、npx 或手动克隆安装，被任意兼容 agent 使用。

二、核心优势

1. 规范兼容：遵循 agentskills.io 规范，Claude Code/Codex/OpenCode 通用。
2. 覆盖全面：从 OFM 写作、Bases、Canvas 到 CLI、网页抽取、批量模板。
3. 省 token：defuddle 清理网页 clutter，降低喂给模型的噪声。
4. 多安装：marketplace / npx / 手动克隆三种方式。
5. 纯本地：技能在本地 agent 环境运行，笔记数据不出本机。

三、适用场景

• 让 agent 按 Obsidian 语法自动整理与生成笔记。
• 用 AI 管理 Bases 视图、筛选与公式。
• 批量从结构化数据生成 Markdown/笔记模板。
• 把网页内容干净抽取进 Obsidian 知识库。

四、安装教程

Marketplace：

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

或用 npx：

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

Claude Code 手动：把仓库内容放入 vault 根目录的 /.claude 文件夹；OpenCode 克隆到 ~/.opencode/skills/ 后重启即可。
常见报错：OpenCode 需克隆整个仓库（保持 skills/ 目录结构），只拷内层会找不到 SKILL.md；Claude Code 需放入正确的 /.claude 路径。

五、使用示例

让 agent 用 obsidian-markdown 写一条带 callout 的笔记：

用 obsidian-markdown 技能，写一条关于“Agent Skills 规范”的笔记，
包含 wikilink 与一个 info callout。

真实效果：agent 输出符合 OFM 的 .md（wikilink、embed、callout、properties），可直接在 Obsidian 打开；配合 defuddle，可把任意网页清理后存成笔记，省下大量 token。

六、常见问题

Q：支持哪些 AI 客户端？
A：任何兼容 Agent Skills 规范的客户端，包括 Claude Code、Codex、OpenCode。
Q：和直接写提示词有什么区别？
A：技能预定义了该领域的标准操作与格式，agent 行为更稳定可控。
Q：数据会出本机吗？
A：技能在本地 agent 环境运行，笔记不经过外部服务。

七、总结

obsidian-skills 把“Obsidian + AI 智能体”的常用能力做成规范化的开源技能包，覆盖写作、Bases、Canvas、CLI、网页抽取与批量模板。对重度 Obsidian 用户，它是把笔记库接上 agent 的捷径；MIT 协议，多安装方式。