Obsidian 技能包
让技能兼容的 Agent 掌握 Obsidian 的 Markdown、Bases、JSON Canvas 和 CLI。
- Star 数
- ★ 50k
- 最近更新
- 1 个月前
- License
- MIT
- FA 评分
- 30/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- Obsidian 用户想要让 Claude Code 在 vault 中创建带 wikilinks 和 callouts 的笔记，使用 obsidian-markdown 技能。
- 不适合
- 不使用 Obsidian 或需要跨笔记应用通用方案的团队
- 不愿在终端执行安装命令、只想要图形界面一键安装的用户
- 依赖非 Claude Code、Codex、OpenCode 等兼容 Agent 的用户
这个 Agent 能做什么，适合哪些场景？
该仓库为 Agent 提供一组遵循 Agent Skills 规范的技能，用于与 Obsidian 集成。它包含五个技能：obsidian-markdown（编辑 Obsidian 特有 Markdown）、obsidian-bases（处理 .base 文件）、json-canvas（操作 .canvas 文件）、obsidian-cli（通过 CLI 与 vault 交互）以及 defuddle（从网页提取干净 Markdown）。这些技能遵循 agentskills.io 规范，可在 Claude Code、Codex 和 OpenCode 等兼容 Agent 中使用。安装方式包括市场插件、npx 或手动配置到各 Agent 的目录。每个技能定义了具体的操作和输出格式，使 Agent 能够直接处理 Obsidian 文件。
该技能包提供预定义的技能，使兼容的 Agent 能够执行 Obsidian 相关任务。它包含五个技能，每个技能对应一组指令：obsidian-markdown 用于创建和编辑 Obsidian Flavored Markdown 文件（包括 wikilinks、embeds、callouts、properties 等）；obsidian-bases 用于创建和编辑 Obsidian Bases 的 .base 文件（支持视图、过滤器、公式和摘要）；json-canvas 用于创建和编辑 JSON Canvas 的 .canvas 文件（节点、边、分组和连接）；obsidian-cli 用于通过 Obsidian CLI 与 vault 交互，涵盖插件和主题开发；defuddle 使用 Defuddle 从网页提取干净的 Markdown 以节省 token。Agent 根据技能指令进行操作，输出遵循 Obsidian 格式。
- Obsidian 用户想要让 Claude Code 在 vault 中创建带 wikilinks 和 callouts 的笔记，使用 obsidian-markdown 技能。
- 数据爱好者需要从网页提取无广告的 Markdown 内容到 Obsidian，使用 defuddle 技能。
- 开发者使用 Obsidian CLI 管理插件和主题，通过 obsidian-cli 技能与 CLI 交互。
- 知识管理用户需要创建和编辑 Obsidian Bases 文件以组织数据，使用 obsidian-bases 技能。
- 视觉思考者使用 JSON Canvas 绘制节点和连接，通过 json-canvas 技能在 Agent 中操作 .canvas 文件。
- 团队采用 Agent Skills 规范，希望在多个 Agent 环境（Claude Code、Codex、OpenCode）中统一 Obsidian 技能。
如何安装或部署这个 Agent？
通过市场安装：在 Obsidian 中运行 /plugin marketplace add kepano/obsidian-skills，然后执行 /plugin install obsidian@obsidian-skills。
通过 npx 安装：运行 npx skills add [email protected]:kepano/obsidian-skills.git（或使用 https URL）。
手动安装 Claude Code：将仓库内容复制到 Vault 根目录的 /.claude 文件夹。
手动安装 Codex：将 skills/ 目录复制到 ~/.codex/skills。
手动安装 OpenCode：克隆整个仓库到 ~/.opencode/skills/ 下，并按照说明保留目录结构。
如何使用这个 Agent？
安装后，根据你的 Agent 环境，技能会自动被发现。对于 Claude Code，确保技能位于 /.claude 目录；对于 Codex，技能位于 ~/.codex/skills；对于 OpenCode，确保在 ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md 找到技能文件。然后，在对话中调用相应技能，例如要求 Agent 创建 Markdown 笔记或提取网页内容。技能会指导 Agent 执行具体操作。对于 Obsidian CLI，需要安装 Obsidian CLI 工具。
这个 Agent 有哪些优点和局限？
- 遵循标准化 Agent Skills 规范，可以在多种 Agent 环境中使用。
- 覆盖多种 Obsidian 功能，从 Markdown 到 Bases 再到 JSON Canvas，功能全面。
- 包含 Defuddle 技能，能有效从网页提取干净内容节省 token。
- 提供多种安装方式（市场、npx、手动），灵活适配不同工作流。
- 依赖 Obsidian 软件和其 CLI，需要用户拥有 Obsidian vault 并安装相关工具。
- 技能专为 Obsidian 设计，不能用于其他笔记应用。
- 安装过程涉及多个步骤，对于不熟悉 CLI 的用户可能有一定门槛。
- 技能的有效性依赖于 Agent 对 SKILL.md 指令的遵循程度，不同 Agent 可能表现不一致。
这个 Agent 与同类方案有什么区别？
与同类技能包相比，该仓库专注于 Obsidian 生态，而其他技能可能覆盖更通用的文件操作。它遵循 agentskills.io 规范，与支持该规范的其他技能包（如官方 Agent Skills）竞争。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Obsidian 技能包 当前 | 30 · 缺口较多 | Agent 插件 / 技能免费 | ★ 50k | 1 个月前 | — | Codex · Claude Code · OpenAI API · Claude API |
| Snyk Agent Scan | 72 · 存在缺口 | 命令行工具免费 | ★ 3.1k | 3 天前 | Python | ChatGPT · Claude Code |
| pigo | 68 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 481 | 1 个月前 | Go | OpenAI API · Claude API |
| Genie | 67 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 345 | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示仓库遵循Agent Skills规范，技能仅提供指令和示例，未发现要求过度权限或执行危险操作。但缺少用户确认机制、数据流透明性、敏感数据处理说明、依赖安全审计、外部影响控制、回滚方案。来源归属仅通过MIT许可证和作者署名体现，但发布者未经验证。
技能描述与README中的技能列表一致，但未提供错误处理或失败消息。依赖项（如Obsidian CLI、Defuddle）在README中提及，但未提供版本或可用性保证。
README明确了目标用户（Obsidian用户）和多种安装场景（Claude Code、Codex、OpenCode），但技能触发条件未详细说明，能力边界仅通过技能描述隐含。环境适配覆盖了主流工具，但未说明版本兼容性。
信息架构清晰，README提供了安装说明和技能列表，但缺少已知限制、版本变更日志、维护责任说明。许可证为MIT，命名稳定但未提供版本号。
技能输出为Markdown、Bases、JSON Canvas等格式，可直接用于Obsidian，但未提供示例或FAQ。边际价值在于节省token和简化Obsidian操作，但成本效益未量化。
README中的声明（如技能遵循规范）可追溯至外部规范，但未提供独立验证。技能描述与README一致，但未区分事实与推断。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 发布者身份未经验证，使用前应审查技能内容。
- 缺少用户确认机制，技能可能自动执行修改操作。
- 依赖项（如Obsidian CLI）版本未锁定，可能引入不兼容或安全风险。
- 未提供回滚方案，误操作可能导致数据丢失。