obsidian-skills 是什麼、怎麼安裝：Obsidian CEO kepano 寫的 Agent Skills，讓 Claude Code 讀寫 Obsidian 筆記庫

本文根據 kepano/obsidian-skills 倉庫 README、Obsidian 官方幫助文檔以及 Claude Code、Codex 官方文檔整理，資料核對於 2026-10-10。

是什麼

obsidian-skills 是一組給 Obsidian 用的 Agent Skills，作者是 Steph Ango（網名 kepano），也就是筆記軟件 Obsidian 的 CEO。Obsidian 的筆記是本地的 Markdown 文件，天然適合讓編程智能體直接讀寫；但 Obsidian 有自己的一套語法和文件格式，比如雙鏈、嵌入、提示框、屬性，以及 .base 數據視圖和 .canvas 白板，通用模型經常寫得似是而非。這個倉庫把這些格式的正確寫法教給智能體。

技能遵循 Agent Skills 規範，README 寫明可用於任何兼容的智能體，點名了 Claude Code、Codex 和 OpenCode。

截至 2026-10-10，GitHub 顯示該倉庫約 4.9 萬 Star、3500 Fork，最近一次推送 2026-09-15，是筆記類技能裏關注度很高的一個。

包含哪些 Skill

共 6 個，前三個管文件格式，後三個管工具：

• obsidian-markdown：創建和編輯 Obsidian 風格的 Markdown（.md），包括雙鏈、嵌入、提示框、屬性等 Obsidian 特有語法；
• obsidian-bases：創建和編輯 Obsidian Bases（.base），含視圖、篩選、公式和彙總；
• json-canvas：創建和編輯 JSON Canvas 白板文件（.canvas），含節點、連線、分組；
• obsidian-cli：通過 Obsidian CLI 與筆記庫交互，也覆蓋插件和主題開發；
• defuddle：用 Defuddle 把網頁提取成乾淨的 Markdown，去掉雜亂內容以節省 token；
• knap：用 Knap 把 JSON 或 CSV 數據套進 Markdown 模板，支持批量生成文件。

怎麼安裝

Claude Code 插件市場（在會話裏輸入）：

text
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

npx skills：

text
npx skills add https://github.com/kepano/obsidian-skills

README 把 SSH 地址的寫法 npx skills add [email protected]:kepano/obsidian-skills.git 放在前面，沒配 SSH 密鑰的用上面的 https 版本即可。

手動安裝：

• Claude Code：把倉庫內容放進筆記庫根目錄（或你用 Claude Code 打開的那個文件夾）下的 /.claude 文件夾；
• Codex：README 寫的是把 skills/ 目錄複製到 Codex 技能路徑（通常是 ~/.codex/skills）。Codex 官方文檔當前寫的用戶級目錄是 ~/.agents/skills，以官方文檔為準；
• OpenCode：整倉克隆到技能目錄，注意不要只複製裏面的 skills/ 文件夾：

sh
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

怎麼用

在筆記庫所在的文件夾裏啟動智能體，然後直接提要求，技能會按內容自動加載：

• 「把這份會議記錄整理成一篇筆記，加上日期和參會人屬性，人名用雙鏈」——用到 obsidian-markdown；
• 「建一個 Base，列出所有帶 #讀書 標籤的筆記，按評分排序」——用到 obsidian-bases；
• 「把這個項目的模組關係畫成一張 Canvas」——用到 json-canvas；
• 「把這個網頁存成筆記，只保留正文」——用到 defuddle。

在 Claude Code 裏可以用 /skills 確認技能已識別。obsidian-cli、defuddle、knap 三個技能分別依賴對應的命令行工具，要先按各自的官方說明裝好。

適合誰 / 不適合誰

適合：

• 重度 Obsidian 用戶，想讓 AI 幫忙整理、歸檔、批量改寫筆記；
• 用 Obsidian 做知識庫或項目管理，需要自動生成數據視圖和白板的人；
• 開發 Obsidian 插件、主題的作者。

不適合：

• 用 Notion、飛書文檔等雲端筆記的人——技能針對本地 Markdown 文件；
• 不想在電腦上裝命令行智能體、只在手機上記筆記的用戶。

注意事項

• 許可證：MIT，倉庫根目錄有 LICENSE 文件，版權方為 Steph Ango。
• 維護狀態：最近一次推送 2026-09-15；Obsidian 的 Bases、CLI 等功能本身還在演進，語法以 Obsidian 官方幫助文檔為準。
• 安全：智能體會直接改寫筆記庫裏的文件，批量操作前先備份或用 git 管理筆記庫，方便回退。defuddle 會聯網抓取網頁，網頁裏可能夾帶誘導智能體的文字，抓回來的內容當資料看，不要讓它照着執行；obsidian-cli 能操作整個筆記庫，執行前看清命令。從別處下載的改版技能，安裝前先讀 SKILL.md。
• 兼容性：README 只寫了 Claude Code、Codex、OpenCode 三種手動安裝方式；claude.ai 網頁版讀不到你本地的筆記庫，不適用。