前言¶
维护 Obsidian 仓库时，日常动作往往很琐碎：在当前笔记里插入链接、按日期生成每日笔记、把散落的 todo 归拢、按标签或属性筛选笔记、检查断链和书签。这些事在图形界面里靠点击完成，重复多次就变成负担；想脚本化，又得自己对着 CLI 参数反复试。下面介绍的 obsidian-cli 技能，就是把这套仓库操作封装成可直接调用的能力。
这是什么¶
obsidian-cli 是一个基于通用 SKILL.md 格式的技能，面向官方 Obsidian CLI（v1.12+），定位是「完整的保险库自动化」。它由 adolago 发布，来源为 clawhub，坐标 @clawhub_adolago/obsidian-cli，当前版本 2.0.0，分类 knowledge-management，标签 requires_api_key=false。
也就是说：它不是又一个 Obsidian 插件，而是一层技能封装，把官方 CLI 的能力整理成结构化的操作入口，供 Cursor、Codex CLI、Claude Code 这类客户端按需调用。
核心功能¶
依据 Skill 简介，该技能覆盖以下能力域：
- 文件操作：对 Vault 内的文件进行读写与组织。
- 每日笔记：按日期维度创建或定位笔记。
- 搜索：在保险库范围内检索内容。
- 任务：处理笔记中的任务条目。
- 标签：按标签查询与整理。
- 属性：读写 frontmatter 等元数据属性。
- 链接：处理笔记间的链接关系。
- 书签：管理书签。
- 基础：常规基础操作。
需要注意的是，简介只给出了能力域的划分，没有列出每个域对应的具体命令与参数。具体命令以官方 Obsidian CLI 为准，技能负责把这些能力暴露给上层 Agent。
安装与启用¶
抓取到的 SkillHub 页面没有给出安装命令、目录路径或配置字段，因此这里不推测。可确认的信息如下：
坐标：@clawhub_adolago/obsidian-cli
上游仓库：https://clawhub.ai/adolago/obsidian-cli
SkillHub 页面：https://www.skillhub.cn/skills/clawhub_adolago/obsidian-cli
启用方式建议直接打开上述 SkillHub 页面与上游仓库，按发布者给出的说明操作；在没有核实到命令之前，不建议自行猜测安装入口。
关于客户端差异：本次抓取未能核实该技能在 Cursor、Codex CLI、Claude Code 之间的安装方式是否存在差异，因此不做分别说明。基于 SKILL.md 通用格式这一点，它通常可被支持该格式的客户端加载，但具体支持程度请以客户端文档为准。
前置条件是本地已安装并可用官方 Obsidian CLI（v1.12+）。技能本身不含 CLI 二进制，不会替代官方 CLI。
典型用法¶
由于资料中没有提供可复现的命令行示例，本节只描述能力调用方向，不虚构具体命令。
1、文件与每日笔记：新建笔记、向已有笔记追加内容、按日期定位每日笔记。适合做日报、周报的自动化落盘。
2、检索：按关键词在保险库内搜索，再按标签或属性二次筛选。适合「找出所有未完成的、带特定标签的笔记」这类查询。
3、任务与属性：读取笔记中的任务条目，写入或更新 frontmatter 属性。适合批量整理元数据。
4、链接与书签：检查笔记之间的链接关系，维护书签列表。适合做仓库体检。
使用时先确认本地官方 CLI 能正常执行，再在 Agent 客户端中调用技能；如果某个能力域的实际表现与预期不符，优先核对官方 CLI 版本是否达到 v1.12+。
适用场景与注意¶
适合：重度使用 Obsidian、希望把仓库维护动作交给脚本或 Agent 的开发者；需要在 CI 或定时任务里批量整理笔记的人；以及正在用 Cursor、Codex CLI、Claude Code 做知识库自动化的人。
注意：
- 该技能依赖官方 Obsidian CLI，未安装或版本低于 v1.12+ 时无法工作。
- 它操作的是本地保险库，注意备份；批量写入类动作建议先在副本上验证。
requires_api_key=false表示不需要额外 API key，但仍需保证本地 CLI 已就绪。- 评分与下载量为抓取时点的页面数据：SkillHub 显示评分 100000、下载 19301、安装 328。这些数字随时间变化，不构成使用依据。
结尾¶
obsidian-cli 的价值在于把 Obsidian 仓库的高频操作从图形界面搬进命令行与 Agent 调用链，省去重复点击，也让笔记维护可以脚本化。如果你的日常维护集中在文件、每日笔记、搜索、任务、标签、属性、链接与书签这几类动作上，值得先装好官方 Obsidian CLI，再按官方页面说明启用这个技能。
官方地址：https://api.skillhub.cn/user_46180358/obsidian-cli
