让AI接管你的Obsidian知识库obsidian-skills 上手实战【免费下载链接】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助手帮忙整理笔记结果打开生成的文件维基链接写成了普通文本标注框语法支离破碎.base文件里还冒着一堆 YAML 报错。问题往往不在AI的能力而在于它根本看不懂 Obsidian 自己的方言。obsidian-skills 就是冲着这一点来的技能包——Claude Code、Codex、OpenCode 装上之后AI 就能直接创建和修改 Obsidian 的 Markdown 笔记、Bases 数据视图、JSON Canvas 画布这几类特有文件。 它到底是什么30秒讲清楚打个比方。AI助手就像一个编程能力很强的新员工但没接触过你们公司的文档系统——它不知道[[笔记名]]是链接、不知道标注框长什么样、更不知道.canvas文件里节点和连线的规矩。obsidian-skills 就是那本入职手册每个技能是一份按 Agent Skills 规范写成的说明文档SKILL.md 加配套参考把一个文件格式的语法、易错点和自查清单交代得明明白白。放到你助手对应的目录里它自己就会学。全部五个技能都在 skills/ 目录下各管一摊Obsidian 风味 Markdown、Bases 数据视图.base、JSON Canvas 画布.canvas、Obsidian 命令行操作以及用 defuddle 从网页提取干净内容。 上手体验五步跑通第一张原生笔记拿到仓库git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills按你用的助手放置文件Claude Code 用户把仓库内容放进库根目录的.claude文件夹Codex 用户把skills/目录拷到~/.codex/skillsOpenCode 用户直接把整个仓库克隆到~/.opencode/skills/——注意是整仓克隆只拷内层skills/文件夹会弄坏目录结构。重启助手。OpenCode 会自动扫描所有 SKILL.md不用改任何配置文件。开口下第一单给我建一张笔记顶部放一个警告标注框再链到『项目』那张笔记。打开 Obsidian 验收标注框渲染出来了、链接可跳转、属性区有 frontmatter就算跑通。 核心能力拆解每个技能解决什么问题让AI写出能直接读的笔记场景AI 产出一篇标准 Markdown丢进 Obsidian 里链接不通、元数据缺失看着就别扭。做法obsidian-markdown 技能把 Obsidian 特有的那套语法教给它——库内互链用[[笔记名]]重命名时引用会自动跟着走嵌图片、PDF 或别的笔记用![[文件]]提示框用 [!warning]文件头写 title、tags、aliases。每种写法还配了完整参考见 skills/obsidian-markdown/。效果AI 交付的笔记打开即可读不用你再逐行修。把一堆笔记变成可查询的表场景库里几百张笔记标签和属性散落各处想纵览一遍只能人肉翻。做法AI 生成.base文件先用 filters 圈定要纳入哪些笔记按标签、文件夹或属性都行再用公式算出距截止还有几天是否逾期这类派生值最后挑表格、卡片或列表视图。骨架长这样filters: and: - file.hasTag(task) - status ! done formulas: days_until_due: if(due, (date(due) - today()).days, ) views: - type: table name: 进行中 order: [file.name, status, due, formula.days_until_due]效果笔记从静态存储变成了活的数据库还能用![[xxx.base]]嵌进任意笔记里随开随看。用对话把想法变成关系图场景脑子里一团相互关联的概念想理清楚却懒得动手画。做法AI 生成.canvas文件——文本节点加连线每个节点有唯一 ID 和坐标分组、配色、箭头方向都替你想好写完还会自查 ID 是否唯一、每条连线是否都挂在真实存在的节点上杜绝悬空连线。效果你嘴上说结构它交出可拖拽调整的思维导图。在终端里操作活着的Obsidian场景想批量改一批笔记的属性或者你是插件开发者每次改完代码都要手动重载看效果。做法obsidian-cli 技能教 AI 用obsidian命令驱动一个运行中的 Obsidian 实例建笔记、搜索、设属性插件开发则走重载—查错—截图验证的循环obsidian property:set namestatus valuedone file我的笔记 obsidian plugin:reload idmy-plugin效果重复性操作压成一行命令插件调试一圈的时间肉眼可见地变短。存网页正文顺便省 token场景把 URL 丢给 AI 让它总结它抓回来的却是导航栏、评论区加广告的大杂烩。做法AI 改用defuddle parse url --md先把正文抽成干净的 Markdown需要留档时还能直接落成文件。效果内容少了重点反而更准处理成本也跟着降下来。️ 真实场景走一遍研究生的一周我每周要读十来篇论文。周一把新论文的链接丢给助手存一下。defuddle 先抽出干净正文AI 按文献卡模板落笔记——frontmatter 里记作者、年份、关键词核心结论放进标注框关键概念用维基链接挂到知识库里的概念卡上。周五我说一句更新文献表它就改那张.base进行中的按状态分组公式列显示剩余天数快逾期的自动排到前面。周日写 related work再让它用 json-canvas 把研究问题和几篇相关文献的关系画出来我负责把节点拖到顺眼的位置。整个流程里我基本只在动嘴。️ 踩坑与调优三个最高频的卡点.base文件提示 YAML 错误、视图不渲染→ 多半是两种情况含冒号等特殊字符的字符串没加引号或公式里双引号套了双引号。解法显示名用双引号包住公式整体用单引号包。技能没被识别AI 还是裸奔状态→ 路径没对上工具。OpenCode 要求目录结构是仓库/skills/技能名/SKILL.md只拷内层文件夹就容易坏。摆正路径、重启助手一般就好了。日期差算剩余天数时公式报错→ Bases 里两个日期相减得到的是 Duration 而不是数字得先取.days再参与四舍五入另外不是每张笔记都有截止日期记得用if()兜底空值不会炸。往前看一步五个技能天生适合串成流水线defuddle 抽取 → Markdown 卡片 → Bases 统计 → Canvas 可视化现在已经能端到端跑通插件开发者则可以把 CLI 的重载—截图—查错循环变成固定动作。技能格式遵循的是开放的 Agent Skills 规范社区以后往上面加新格式、新流程助手在库里能做的事只会更多。写在最后obsidian-skills 做的事说白了就一件把 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辅助生成（AIGC），仅供参考