最近半年來，用 Claude 這類 AI 工具搭配 Obsidian 打造「AI 第二大腦」的玩法在網路上爆紅，不少讀者也跟著阿正老師的教學把 Claude 接進了自己的筆記庫。不過玩過的朋友應該都遇過類似的狀況：AI 雖然會讀寫 Markdown 檔案，卻常常「不懂 Obsidian 的規矩」——雙向連結 [[wikilink]] 寫成一般網址、Callout 提示框語法寫錯、屬性（Properties）格式亂七八糟，改完還得自己再修一輪，實在有點阿雜。
好消息是，這個問題現在有了「半官方」的解法！Obsidian 的執行長 Steph Ango（網路上更為人熟知的 ID 是 kepano）親自在 GitHub 上開源了一套名為 obsidian-skills 的 AI 技能包，等於是由 Obsidian 官方掌門人親自寫好「使用說明書」教 AI 怎麼正確操作 Obsidian。這個專案推出後迅速竄紅，截至 2026 年 7 月已累積超過 4 萬顆星，是目前最熱門的 Agent Skills 專案之一。
更棒的是，它完全免費（MIT 授權）、安裝超簡單，而且不是只有工程師在用的 Claude Code 才能裝——一般人天天在用的 Claude Desktop 用滑鼠點幾下就能安裝，ChatGPT 也支援同一套 Agent Skills 開放標準。這篇文章阿正老師就以 Claude Desktop 為主角，帶大家從觀念、事前準備到安裝實作，一次搞懂這套技能包該怎麼玩！
文章目錄
一、什麼是 obsidian-skills？為什麼 Obsidian CEO 要自己寫
先簡單複習一下什麼是「Skill（技能）」：它其實就是一份寫給 AI 看的說明書（Markdown 文字檔），告訴 AI 在什麼情況下該用什麼工具、遵守什麼格式規則。AI 工具（如 Claude 或 ChatGPT）在工作時會自動讀取相關的技能檔，等於是「先看過操作手冊再動手」，做出來的結果自然精準許多。如果你對 Skill、MCP、Agent 這些名詞還不太熟，可以先看看阿正老師之前寫的這篇觀念文：《如果 AI Agent 是一間公司：一次搞懂 AI Agent、MCP、RAG、Memory、Skill 與 Multi-Agent》。
而 obsidian-skills 就是一套專門針對 Obsidian 的技能合集，由 Obsidian 執行長 Steph Ango（kepano）親自撰寫並開源。它遵循 Agent Skills 開放規範，所以任何支援這套規範的 AI 工具都能使用——從一般人最好上手的 Claude Desktop，到 Claude Code、ChatGPT／Codex、OpenCode 都在支援之列。由「原廠老闆」親自出手的好處是：這些技能檔對 Obsidian 特有語法（wikilink、Callout、Properties、Bases 等）的描述最權威，AI 照著做基本上不會出現「格式不合 Obsidian 習慣」的問題。
| 官方網站 | https://github.com/kepano/obsidian-skills |
| 最新版本 | 無固定版本號（GitHub 持續更新中） |
| 支援工具 | Claude Desktop、Claude Code、ChatGPT（Business／Enterprise 等工作方案）、Codex、OpenCode 等支援 Agent Skills 規範的 AI 工具 |
| 費用 | 完全免費（MIT 開源授權） |
| 繁體中文 | 技能檔內容為英文，但 AI 讀懂後可用中文與你互動，處理繁中筆記沒有問題 ✅ |
| 軟體下載 | [Claude Dekstop本站下載點] [ChatGPT本站下載點] |
二、五個技能一次看懂
obsidian-skills 目前包含五個技能，各自負責 Obsidian 生態的一種「開放格式」或工具。你不需要五個都用到，AI 會依照任務自動挑選合適的技能來讀。以下阿正老師用白話幫大家整理：
| obsidian-markdown | 教 AI 撰寫「Obsidian 風味 Markdown」：雙向連結 [[wikilink]]、嵌入（Embeds）、提示框（Callouts）、筆記屬性（Properties）等專屬語法。這是最常被用到、也最推薦一般用戶關注的技能。 |
| obsidian-bases | 教 AI 建立與編輯 Obsidian 的資料庫功能 Bases（.base 檔案），包括檢視（Views）、篩選器、公式與摘要欄位。想用 AI 幫你把一堆筆記整理成類似 Notion 資料庫的表格檢視，就靠它。 |
| json-canvas | 教 AI 讀寫 JSON Canvas 開放格式（.canvas 檔案），也就是 Obsidian 的白板功能——節點、連線、群組都能讓 AI 幫你畫。 |
| obsidian-cli | 教 AI 使用 Obsidian 1.12 推出的官方命令列工具（CLI），直接對正在執行的 Obsidian 下指令：讀寫筆記、搜尋、管理任務與屬性、查反向連結等，甚至還支援外掛開發除錯。這是整套技能包裡「威力最大」的一個，下一章會教大家怎麼啟用 CLI。 |
| defuddle | 教 AI 使用 kepano 的另一個開源工具 Defuddle，把網頁抽取成乾淨的 Markdown、去除廣告與雜訊，順便節省 AI 的 token 用量。做網頁剪藏進筆記庫超好用。 |
三、事前準備：Obsidian 1.12.4 與官方 CLI 啟用教學
五個技能中，obsidian-markdown、obsidian-bases、json-canvas 與 defuddle 只要有 AI 工具就能直接用；但威力最大的 obsidian-cli 技能需要先啟用 Obsidian 的官方 CLI 才行。這裡幫大家整理一下時間軸：Obsidian 官方 CLI 在 2026 年 2 月 10 日隨 1.12.0 早期測試版推出（當時僅限付費贊助的 Catalyst 會員搶先體驗），並在 2026 年 2 月 27 日的 1.12.4 正式版開放給所有用戶免費使用，不需要任何訂閱或授權。
啟用步驟非常簡單：
- 確認 Obsidian 已更新至 1.12.4 或更新版本（可在「設定 → 關於」查看版本，並用「檢查更新」升級）。
- 開啟「設定 → 關於」，找到「命令列介面」項目並打開開關。
- 依照畫面提示點選「註冊」，Obsidian 會嘗試自動把 CLI 加入系統的環境變數（PATH）。
- 開一個新的終端機視窗（舊視窗不會載入新的 PATH 設定），輸入
obsidian help測試，若列出指令清單就代表成功了！
啟用之後，你就可以在終端機直接對筆記庫下指令，例如：
obsidian read file="我的筆記" # 讀取一則筆記 obsidian search query="關鍵字" # 搜尋整個筆記庫 obsidian daily:append content="- [ ] 新任務" # 在今日日記加一筆待辦 obsidian backlinks file="我的筆記" # 查詢反向連結
⚠️ 注意：根據官方技能檔的說明，CLI 需要 Obsidian 應用程式處於開啟狀態才能運作，它比較像是「遙控」正在執行的 Obsidian，而不是獨立的背景工具。另外 Windows 用戶請務必更新到 1.12.4 以上，早期版本在 Windows 上有路徑偵測與 Unicode（中文檔名可能受影響）的問題，1.12.4 已修正。若輸入指令出現「command not found」，先試著重開終端機視窗。
四、四種安裝方式：Claude Desktop／Claude Code／npx／手動
obsidian-skills 提供多種安裝方式，可以依照你使用的 AI 工具與熟悉程度來挑選。阿正老師建議一般用戶直接用第一種——在 Claude Desktop 裡用滑鼠點幾下就裝好，完全不用碰指令！
方式一：Claude Desktop Plugin （最推薦）
1.先打開Claude Dekstop程式，點擊左方的「Customize」 ，再點擊「Plugins」，按下右上角的＋號按鈕。
2.此時會出現新增marketplace（市集）視窗，選擇第二項：
3.輸入github的網址（https://github.com/kepano/obsidian-skills）：
4.安裝完成後，就可在視窗中看到「Obsidian」這個plugin了。
方式二：Claude Code Plugin Marketplace
在 Claude Code 中依序輸入以下兩個指令即可：
/plugin marketplace add kepano/obsidian-skills /plugin install obsidian@obsidian-skills
方式三：npx skills（跨工具通用）
如果你的電腦已安裝 Node.js，可以在終端機用一行指令安裝：
npx skills add https://github.com/kepano/obsidian-skills
方式四：手動安裝（進階用戶）
- Claude Code：把整個 repo 的內容放進筆記庫（Vault）根目錄的
/.claude資料夾中。 - Codex：把
skills/目錄複製到 Codex 的技能路徑（通常是~/.codex/skills）。 - OpenCode：把整個 repo（不是只有 skills 資料夾）clone 到
~/.opencode/skills/底下，重啟 OpenCode 就會自動偵測，不用改任何設定檔。
那 ChatGPT 用戶怎麼辦？
ChatGPT 同樣支援 Agent Skills 這套開放標準：只要在ChatGPT桌面版軟體，點擊左側的「外掛程式」，再點擊右上角的「建立」→「新增市集」，輸入github的套件網址，即可使用。不過要特別注意，依照 OpenAI 官方說明，ChatGPT 的 Skills 功能目前主要開放給 Business、Enterprise、Edu 等工作方案（Codex 與 API 也支援），一般免費版與 Plus 個人帳號是否開放，請以 OpenAI 官方公告為準（阿正老師使用的是Plus帳號，可以安裝成功）。
✅ 優點
- Obsidian CEO 親自撰寫，語法描述最權威
- 完全免費、MIT 授權，可自行修改成專屬版本
- 遵循開放的 Agent Skills 規範，不綁定單一 AI 工具
- 安裝門檻低，Claude Desktop 用滑鼠點幾下就裝好
- 涵蓋 CLI、Bases、Canvas 等最新功能
⚠️ 缺點
- 技能檔內容為英文（不影響處理中文筆記）
- obsidian-cli 技能需 Obsidian 1.12.4 以上並手動啟用 CLI，且要有能執行終端機指令的 AI 環境才能發揮完整威力
- ChatGPT 的 Skills 功能目前主要開放給 Business／Enterprise 等工作方案，個人帳號支援情況待確認
- AI 直接修改筆記仍有風險，備份習慣不可少
阿正老師點評：以阿正老師的使用習慣來看，「方式一」裝完就忘、最省事；但如果你想研究技能檔怎麼寫、甚至改造出自己的版本，建議用「方式四」手動放進 Vault 的
.claude 資料夾，之後打開來讀讀看這些 SKILL.md 是怎麼寫的，對學習撰寫自己的 Skill 非常有幫助。
五、實際應用情境範例
裝好之後不需要任何額外設定，AI 會在遇到相關任務時自動載入對應的技能。要提醒的是：如果你用的是 Claude Desktop或ChatGPT，記得先讓 Claude/ChatGPT 能存取你的筆記庫資料夾（使用Claude cowork或ChatGPT的work），技能才有東西可以操作。以下是幾個建議大家可以嘗試的情境（實際效果會依你的筆記庫內容與 AI 模型而異，建議測試時先從小範圍開始觀察）：
- 寫日記兼記待辦：直接跟 Claude 說「幫我在今天的日記加上這三件待辦事項」，AI 會透過 CLI 的
daily:append指令（或直接編輯日記檔案）寫進每日筆記，格式完全符合 Obsidian 的任務語法。 - 整理混亂的標籤與屬性：請 AI 掃描筆記庫，找出同義但寫法不一的標籤（例如
#AI與#人工智慧），統一成一致的屬性格式。 - 網頁剪藏：丟一個網址給 AI，請它用 Defuddle 抽出乾淨的 Markdown 內容、加上來源屬性後存進筆記庫的「剪藏」資料夾（如上圖就是使用/defuddle技能來抓取我的BLOG文章成為MD檔）。
- 建立資料庫檢視：請 AI 幫你建一個
.base檔，把所有「狀態＝進行中」的專案筆記整理成表格檢視，還能加上篩選與排序。 - 畫白板整理思路：請 AI 把某個主題的相關筆記畫成一張 Canvas 白板，用節點與連線呈現彼此的關係。
- 找出孤兒筆記：請 AI 用 CLI（需先依第三章啟用）查出沒有任何連結指向的筆記，幫你補上合適的 wikilink，讓知識網路越織越密。
如果你還沒建立自己的 AI 筆記工作流，強烈建議先閱讀阿正老師的《用 Claude＋Obsidian 打造你的 AI 第二大腦》完整教學（連結待補），把 Vault 與 CLAUDE.md 的基礎打好，再回來裝這套技能包，效果會加倍！
六、使用注意事項與安全建議
讓 AI 直接讀寫你的筆記庫雖然方便，但畢竟筆記是多年累積的心血，以下幾點請務必留意：
- 備份第一：在讓 AI 大規模整理筆記之前，務必先備份整個儲存庫( Vault) 資料夾（或用 Git 做版本控制）。AI 再聰明也可能誤判，有備份才能安心實驗。
- 小步快跑：建議測試時可以觀察 AI 先在少量筆記上的處理結果，確認格式正確後再放手讓它處理整個筆記庫，不要一開始就下「幫我重整全部筆記」這種大範圍指令。
- CLI 權限意識：啟用 CLI 後，任何能執行終端機指令的程式理論上都能操作你的筆記庫，請只搭配你信任的 AI 工具使用。
- 技能會持續更新：這個專案更新頻繁，指令語法在未來版本可能調整；若發現 AI 的操作方式跟技能檔描述不符，可以到 GitHub 專案頁看看是否有新版本。
七、阿正老師的總結
obsidian-skills 是那種「小而美」的專案：它沒有華麗的介面，本質上就是幾份寫得極好的說明書，但正因為出自 Obsidian 掌門人之手，這幾份說明書讓 AI 與 Obsidian 之間的「語言隔閡」幾乎消失。搭配 2026 年新推出的官方 CLI，AI 第二大腦的整套工作流終於算是打通任督二脈了。
已經在用 Claude＋Obsidian 的用戶
→ 直接安裝。在 Claude Desktop 點幾下滑鼠（或在 Claude Code 打兩行指令）就能讓 AI 產出的筆記格式大幅進化，沒有理由不裝。
想學怎麼寫自己的 Skill 的用戶
→ 把它當教材。手動安裝後打開每個 SKILL.md 研讀，這是目前最好的 Agent Skills 範本之一。
還沒接觸過 AI 筆記工作流的新手
→ 先打基礎再回來。建議先把 Obsidian 與 Claude 的基本串接學會，再裝技能包錦上添花。
AI 第二大腦的最後一塊拼圖
從 Obsidian 官方 CLI 在 2026 年 2 月免費開放，到 CEO 親自開源這套技能包，可以明顯感受到 Obsidian 正在全力擁抱 AI Agent 時代——而且走的是「開放格式、本地優先」的路線，你的筆記永遠是你自己的。阿正老師會持續追蹤這個專案的更新，也會把更多 AI＋筆記的實戰玩法整理成文章分享給大家。你已經開始用 AI 管理筆記了嗎？用起來有什麼心得或踩過什麼雷？
歡迎在下面留言跟阿正老師分享！
