作者 kepano · kepano/obsidian-skills
來自 kepano（Obsidian 設計主任）的技能，教代理真正的 Obsidian——Markdown、Bases、JSON Canvas、CLI。
obsidian-skills 是 Steph Ango（kepano，Obsidian 設計主任）的技能套件。它不將 Obsidian 視為「只是一堆 .md 檔案」，而是教代理真正的慣例：反向連結、屬性、Dataview／Bases 查詢、JSON Canvas、嵌入。另外還有使用 Obsidian CLI 以程式方式操作 vault 的技能。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"obsidian-skills-kepano": {
"command": "git",
"args": [
"clone",
"https://github.com/kepano/obsidian-skills",
"~/.claude/skills/obsidian-kepano"
],
"_inferred": true
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"obsidian-skills-kepano": {
"command": "git",
"args": [
"clone",
"https://github.com/kepano/obsidian-skills",
"~/.claude/skills/obsidian-kepano"
],
"_inferred": true
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"obsidian-skills-kepano": {
"command": "git",
"args": [
"clone",
"https://github.com/kepano/obsidian-skills",
"~/.claude/skills/obsidian-kepano"
],
"_inferred": true
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"obsidian-skills-kepano": {
"command": "git",
"args": [
"clone",
"https://github.com/kepano/obsidian-skills",
"~/.claude/skills/obsidian-kepano"
],
"_inferred": true
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "obsidian-skills-kepano",
"command": "git",
"args": [
"clone",
"https://github.com/kepano/obsidian-skills",
"~/.claude/skills/obsidian-kepano"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"obsidian-skills-kepano": {
"command": {
"path": "git",
"args": [
"clone",
"https://github.com/kepano/obsidian-skills",
"~/.claude/skills/obsidian-kepano"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add obsidian-skills-kepano -- git clone https://github.com/kepano/obsidian-skills ~/.claude/skills/obsidian-kepano一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 多年的筆記——標籤、屬性、檔案命名都不一致。
tag: 統一遷移為 YAML tags: 屬性。✓ 已複製結果： 搜尋和連結都運作順暢的 vault。
何時使用： 你想要對專案筆記有型別化的檢視。
結果： 可運作的 Base；你可以排序、篩選、分組你的專案。
何時使用： 你想要一張筆記在某個主題上如何連結的視覺地圖。
結果： 可在 Obsidian 中打開並視覺探索的 canvas。
與 Daniel 的 Claude × Obsidian 技能疊加
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| audit_vault | path | 定期清理 | 按 vault 大小縮放的 token |
| design_base | folder | 採用 Bases | token |
| render_canvas | note_set, layout? | 視覺地圖 | token |
| obsidian_cli | command | 透過 CLI 進行批次操作 | 解析輸出的 token |
vault 的讀取／寫入Bases schema 被拒屬性型別必須在所有筆記中一致——技能會標記違規者
Canvas 重疊縮小分群大小，或在 Obsidian 中手動清理
找不到 CLI 指令單獨安裝 Obsidian CLI；技能假設它在 PATH 中
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| claude-obsidian-skill | 你想要日常驅動的工作流程模式 | 對較新的 Bases / Canvas 功能覆蓋較少 |
| 手動使用 Obsidian | 小型 vault | 難以擴展到數千個筆記 |