Skip to content

Obsidian Vault Manager

Search, create, move and edit notes in your Obsidian vault using obsidian-cli

Stars
11,367
Licence
MIT
Files
1 file

What it does

Obsidian is a note-taking app that stores notes as plain Markdown files in a folder on your computer. With this skill installed, the agent learns how to find your Obsidian vaults, search note names and contents, create new notes, and safely move or delete them using the obsidian-cli command-line tool. Moving a note also updates links to it across the vault, which a plain file move would not do.

Great for

  • People who keep their notes in Obsidian and want an AI agent to search, organise or draft notes for them
  • Developers or power users who script around a Markdown note collection
  • Anyone who wants bulk note clean-up such as renaming or reorganising folders without breaking wikilinks

Skip it if

  • Users who do not use Obsidian, since the skill assumes an Obsidian vault exists on disk
  • Situations where you cannot risk notes being deleted or moved, because the skill includes delete and move commands that act on your real files
  • Users on systems other than macOS without adjusting the config path, since the documented vault config location is macOS-specific

Try asking

  • “Search my Obsidian vault for every note that mentions 'project budget' and summarise them”
  • “Create a new note called 'Meetings/2024-06 planning' with today's agenda in my default vault”
  • “Rename the note 'old/ideas' to 'archive/ideas' and update all links to it”
  • “Find which vault is currently open in Obsidian and list the notes in its root folder”
Step-by-step guide: how to use Obsidian Vault ManagerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    obsidian.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip obsidian.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip obsidian.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Set a default vault once with obsidian-cli set-default so the agent does not have to guess which vault to use
  • Ask the agent to back up your vault before running bulk move or delete commands
  • Review the agent's planned commands before approving delete operations, since they remove files from your vault

What's inside

  • SKILL.md

Redistributed unmodified from spinabot/brigade under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.