Agent Skills › spinabot/brigade › obsidian

obsidian

GitHub

通过 obsidian-cli 自动化管理 Obsidian 笔记库。支持查找活动库、搜索笔记及内容、创建/移动/删除笔记，并自动维护双向链接。强调读取配置文件而非硬编码路径，确保跨平台兼容性与安全性。

skills/obsidian/SKILL.md spinabot/brigade

Trigger Scenarios

需要搜索或检索 Obsidian 笔记内容时需要创建、移动或删除 Obsidian 笔记时需要获取当前活跃的 Obsidian 库路径时

Install

npx skills add spinabot/brigade --skill obsidian -g -y

More Options

Use without installing

npx skills use spinabot/brigade@obsidian

指定 Agent (Claude Code)

npx skills add spinabot/brigade --skill obsidian -a claude-code -g -y

安装 repo 全部 skill

npx skills add spinabot/brigade --all -g -y

预览 repo 内 skill

npx skills add spinabot/brigade --list

SKILL.md

Frontmatter

{
    "name": "obsidian",
    "homepage": "https:\/\/help.obsidian.md",
    "metadata": {
        "brigade": {
            "emoji": "💎",
            "install": [
                {
                    "id": "brew",
                    "bins": [
                        "obsidian-cli"
                    ],
                    "kind": "brew",
                    "label": "Install obsidian-cli (brew)",
                    "formula": "yakitrak\/yakitrak\/obsidian-cli"
                }
            ],
            "requires": {
                "bins": [
                    "obsidian-cli"
                ]
            }
        }
    },
    "description": "Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli."
}

Obsidian

Obsidian vault = a normal folder on disk.

Vault structure (typical)

Notes: *.md (plain text Markdown; edit with any editor)
Config: .obsidian/ (workspace + plugin settings; usually don’t touch from scripts)
Canvases: *.canvas (JSON)
Attachments: whatever folder you chose in Obsidian settings (images/PDFs/etc.)

Find the active vault(s)

Obsidian desktop tracks vaults here (source of truth):

~/Library/Application Support/obsidian/obsidian.json

obsidian-cli resolves vaults from that file; vault name is typically the folder name (path suffix).

Fast “what vault is active / where are the notes?”

If you’ve already set a default: obsidian-cli print-default --path-only
Otherwise, read ~/Library/Application Support/obsidian/obsidian.json and use the vault entry with "open": true.

Notes

Multiple vaults common (iCloud vs ~/Documents, work/personal, etc.). Don’t guess; read config.
Avoid writing hardcoded vault paths into scripts; prefer reading the config or using print-default.

obsidian-cli quick start

Pick a default vault (once):

obsidian-cli set-default "<vault-folder-name>"
obsidian-cli print-default / obsidian-cli print-default --path-only

obsidian-cli search "query" (note names)
obsidian-cli search-content "query" (inside notes; shows snippets + lines)

Create

obsidian-cli create "Folder/New note" --content "..." --open
Requires Obsidian URI handler (obsidian://…) working (Obsidian installed).
Avoid creating notes under “hidden” dot-folders (e.g. .something/...) via URI; Obsidian may refuse.

Move/rename (safe refactor)