obsidian-cli skill 是什麼、怎麼安裝使用：讓智能體通過 Obsidian CLI 操作筆記庫、調試插件

本文根據 kepano/obsidian-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 7.8 萬次；所在倉庫 kepano/obsidian-skills 在 GitHub 約 4.9 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

直接讀寫筆記庫裏的 Markdown 文件能解決不少事，但有些操作只有 Obsidian 應用自己做才可靠：按它的索引搜尋、處理任務、改屬性、打開某篇筆記。Obsidian 官方提供了命令行工具，obsidian-cli 技能教智能體使用它。description：使用 Obsidian CLI 與筆記庫交互，讀取、創建、搜尋和管理筆記、任務、屬性等；同時支持插件和主題開發，提供重載插件、運行 JavaScript、捕獲錯誤、截圖和檢查 DOM 的命令。用戶要求與筆記庫交互、管理或搜尋筆記、從命令行執行庫操作，或開發調試插件和主題時使用。

一個關鍵前提寫在最前面：obsidian 命令是和正在運行的 Obsidian 實例交互的，需要 Obsidian 處於打開狀態。

技能沒有把命令全部抄一遍，而是告訴智能體運行 obsidian help 查看全部可用命令——這份幫助總是最新的。它重點講了幾條規則：參數用 = 賦值、帶空格的值要加引號、布爾開關不帶值、多行內容用轉義字符；怎樣指定目標文件和目標筆記庫；幾種常見用法；以及插件開發時「改代碼 → 重載 → 檢查」的循環。

怎麼安裝

obsidian-cli 隨 kepano/obsidian-skills 的 obsidian 插件一起安裝。Claude Code 裏輸入（命令來自倉庫 README）：

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

其他智能體用 npx skills add https://github.com/kepano/obsidian-skills，在選擇介面裏勾選 obsidian-cli；也可以把倉庫裏的 skills/obsidian-cli 文件夾直接複製到所用工具的技能目錄。

倉庫整體介紹和其他安裝方式，詳見本站《obsidian-skills 是什麼、怎麼安裝：Obsidian CEO kepano 寫的 Agent Skills，讓 Claude Code 讀寫 Obsidian 筆記庫》。

怎麼用

• 「在我的筆記庫裏搜尋所有提到『續約』的筆記，列出標題和所在文件夾」。
• 「給今天的日記追加一條待辦：週五前回復供應商」。
• 「我在開發一個 Obsidian 插件，改完代碼後幫我重載並看看控制台有沒有報錯」。

這個技能只有一份 SKILL.md。

適合誰 / 侷限

適合希望智能體像使用應用本身那樣操作筆記庫的重度用戶，以及 Obsidian 插件和主題的開發者。電腦上必須裝有帶 CLI 功能的 Obsidian 版本並保持運行；在伺服器或沒有圖形介面的環境裏用不了；claude.ai 網頁版訪問不到你本機的 Obsidian。

注意事項

• 許可：MIT。
• 會執行命令：CLI 能操作整個筆記庫，也包含「運行 JavaScript」這類開發用命令，權限很大——讓它執行前看清命令，重要的庫先備份。
• CLI 的具體命令以 obsidian help 和 Obsidian 官方幫助文檔為準。