你是否想过，你的 Obsidian 笔记本不仅能记录知识，还能自己“动手做事”？obsidian-skills 是一个专为 Obsidian 打造的开源智能体技能集合，它不是插件，而是让 AI 助手（如 Claude Code、Codex CLI、OpenCode 等）真正理解并操作你本地笔记环境的“能力说明书”。它解决了智能体“有脑无手”的痛点——让大模型不仅能读 Markdown，还能创建、修改、查询、可视化甚至调用命令行，在你的知识库中完成真实任务。
核心功能
- 原生支持 Obsidian 核心能力：提供对 Markdown 文件增删改查、双链关系提取、标签/文件夹结构遍历等底层操作技能，让 AI 真正“看懂你的笔记”
- 深度集成 Obsidian 生态插件：内置对 Dataview、JSON Canvas、Bases（数据库插件）、Templater 等热门插件的操作技能，AI 可自动生成数据看板、更新数据库记录、渲染动态图表
- 安全可控的本地 CLI 调用：提供标准化接口，允许经授权的智能体在本地执行 shell 命令（如 git 提交、文件备份、脚本运行），所有操作均在你设备上完成，隐私零外泄
- 跨平台技能通用标准：严格遵循开放的 Agent Skills 规范，同一套技能可无缝用于 Claude Code、Codex CLI、OpenCode、ClawDBot 等多个智能体框架
- 开箱即用的结构化技能包：每个技能以独立
SKILL.md文件定义，含清晰描述、输入输出格式、使用示例和权限说明，开发者可快速复用或二次开发 - 零配置自动发现机制（尤其适配 OpenCode）：只需将仓库克隆至指定目录，重启即可自动加载全部技能，无需手动编辑配置文件，新手友好度极高
适合哪些人用
如果你是以下任一角色，这个项目将极大提升你的知识工作流效率：Obsidian 深度用户（想让 AI 自动整理笔记、生成周报、维护知识图谱）；AI 工具实践者（正在用 Claude Code / Codex / OpenCode 构建个人智能助理）；知识管理架构师（需要自动化维护多源异构笔记体系）；低代码/自动化爱好者（希望用自然语言驱动本地工作流，而非写复杂脚本）；以及教育工作者与研究者（需批量处理文献笔记、生成教学素材、构建领域知识库）。
快速上手
安装极其简单，按你使用的智能体选择对应方式：
- 通过 Obsidian 插件市场（推荐新手）：打开 Obsidian 设置 → 社区插件 → 启用“Beta 版插件市场”，搜索
obsidian-skills并安装启用 - 使用 npx 一键添加（通用快捷）：终端执行
npx skills add git@github.com:kepano/obsidian-skills.git - Claude Code 用户：将本仓库克隆到 Obsidian 仓库根目录下的
/.claude文件夹中 - Codex CLI 或 OpenCode 用户：运行
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills（注意：必须完整克隆，不能只复制 skills 子目录）
安装完成后，重启你的智能体工具，即可在自然语言指令中直接调用“新建会议纪要”“汇总本周所有 #project 笔记”“用 JSON Canvas 渲染当前文件依赖图”等高级操作。
项目信息
Agent skills for Obsidian. Teach your agent to use Markdown, Bases, JSON Canvas, and use the CLI.
27.4k
Stars
1.8k
Forks
Unknown
MIT
编程语言：未知（以 Markdown 和 YAML 为主，无运行时依赖）｜ GitHub Star 数：27,395｜开源协议：MIT｜GitHub 项目地址
这不是又一个花哨的 UI 插件，而是一把真正打开 Obsidian 自动化未来的“技能钥匙”——2.7 万开发者的选择，证明了它正成为下一代知识工作流的基础设施级组件。
