项目介绍
它是一组给 AI 助手阅读的操作说明，不是一个新的笔记软件，也不是装进 Obsidian 就能独立聊天的插件。把技能放进兼容助手的目录，再只授权一个测试笔记库，助手就能参考更具体的 Markdown、Bases 和 JSON Canvas 格式规则处理文件。对普通用户，最值得先试的是生成带属性、双向链接和提示框的笔记。
核心功能
按笔记格式生成与编辑内容
obsidian-markdown 包含属性、双向链接、嵌入和提示框等规则，帮助助手写出更符合 Obsidian 阅读习惯的笔记。
制作节点式白板文件
json-canvas 描述节点、连线和分组结构，可用于生成思路白板；节点 ID 和连线引用仍需验证。
整理 Bases 视图定义
obsidian-bases 面向 .base 文件中的视图、筛选、公式和汇总。它不等于自动修正全部既有笔记数据。
按需使用命令行与网页提取
obsidian-cli 与 defuddle 分别涉及 Obsidian 命令行和网页内容提取，需要另行具备相应工具与权限；基础文件编辑不要求使用它们。
安装与使用
从测试笔记库和基础 Markdown 技能开始。可以下载仓库后按 README 手动复制，无需先配置 API、自建服务器或使用 Obsidian CLI。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请阅读 kepano/obsidian-skills 的 README，为我当前使用的助手选择对应安装方法。先展示目标技能目录，不覆盖已有同名文件。只授权指定测试笔记库，先加载 obsidian-markdown，生成两篇互相链接的测试笔记供我检查；不要批量改写主库、运行命令行扩展或提取网页。- 已安装 Obsidian，并准备不含敏感内容的测试笔记库
- 一个能读取 Agent Skills 并按授权范围编辑文件的兼容助手
- 了解所用助手的模型费用和数据处理方式
- 先备份笔记，再授予测试文件夹所需的最小权限
项目地址：https://github.com/kepano/obsidian-skills
复制地址并按照下方步骤完成设置。- 1下载并选择客户端路径
打开官方仓库下载 ZIP 并解压。先确认自己使用 Claude Code、Codex 还是 OpenCode，再阅读 README 对应段落，避免把一个客户端的目录结构套到另一个上。
- 2手动放入技能目录
Codex 用户将 skills 目录中的技能按当前配置放入技能路径，避免多嵌套一层 skills。Claude Code 按 README 将仓库内容放入笔记库根目录的 .claude 文件夹。OpenCode 要保留完整仓库结构并重启，不能只复制内层 skills。已有同名文件先停下检查。
- 3用测试库检查笔记
只授予测试文件夹权限，让助手使用 obsidian-markdown 创建两篇关联笔记。人工在 Obsidian 阅读视图检查属性、双向链接和提示框，再决定是否应用到真实笔记；命令行安装是可选捷径，不是基础前提。
让助手只在测试笔记库中新建两篇笔记，包含一个指向另一篇的双向链接、tags 属性和一个提示框。在 Obsidian 阅读视图中确认链接可打开、属性和提示框显示正常。若进一步生成 .canvas 文件，检查 JSON 可解析且连线指向存在的节点。
- 这是提供给 AI 助手的 Skills，不是 Obsidian 社区插件管理器中的独立聊天插件。
- Codex 路径应以当前配置为准；README 的典型路径只是参考。
- MIT 许可覆盖仓库技能，模型平台、Obsidian 可选服务和外部工具有各自条款与费用。
使用场景
把阅读摘要整理成关联笔记
让助手将公开阅读材料整理为带主题属性和相互链接的笔记，再人工核对事实。
用白板梳理项目思路
生成少量节点与连线的 JSON Canvas 草图，在 Obsidian 中打开后调整位置和关系。
使用评价
这组技能把常见笔记格式规则集中提供给助手，对已有 Obsidian 使用习惯的人较容易理解。它的价值取决于助手能否正确加载技能，以及用户是否控制好文件权限。本页核对了仓库与格式说明，没有在本机安装或执行笔记编辑测试。
值得一试的地方
- 基础笔记路径不要求编程或服务器
- 多种开放文件格式集中提供规则
- 手动安装和各客户端差异有明确说明
使用前要知道
- 需要兼容 AI 助手，不能作为独立应用运行
- 生成的链接、公式和白板结构仍可能出错
- 命令行与网页提取能力有额外工具依赖
- 最近观察到的默认分支提交为 2026-06-08，未把高星数当成持续更新保证
README
Obsidian Skills
Overview
Obsidian Skills 教 AI 助手按 Obsidian 的文件格式整理笔记、双向链接和白板。适合已经使用 Obsidian 和兼容 AI 助手的人，可先通过复制技能文件使用基础笔记能力，不必编程；命令行操作和网页提取是另外的可选能力。
Getting started
- 从测试笔记库和基础 Markdown 技能开始。可以下载仓库后按 README 手动复制，无需先配置 API、自建服务器或使用 Obsidian CLI。
- 仓库采用 Agent Skills 格式并列出 Claude Code、Codex 和 OpenCode。
- 安装可以走市场、Skills CLI 或客户端对应的手动文件路径。
- 让助手只在测试笔记库中新建两篇笔记，包含一个指向另一篇的双向链接、tags 属性和一个提示框。在 Obsidian 阅读视图中确认链接可打开、属性和提示框显示正常。若进一步生成 .canvas 文件，检查 JSON 可解析且连线指向存在的节点。
Configuration
项目地址：https://github.com/kepano/obsidian-skills
复制地址并按照下方步骤完成设置。