vault — Claude Code skill: what it does, how to install
Configures or initializes an Obsidian vault for the active agent session via the /vault command.
ISC ★ 102 updated 2026-10-25
npx skills add thoreinstein/gemini-obsidian --skill vault -a claude-codeWhat vault does
This skill configures the working Obsidian directory during an assistant session. It delegates requests to obsidian_create_vault when generating a vault or invokes obsidian_set_vault to switch to an existing folder.
If you run the command without arguments, the assistant asks for an absolute path or offers to initialize a new vault. Connecting an existing vault strictly requires a valid .obsidian directory inside the target folder.
What it helps with
- connect an existing Obsidian vault to the current session
- initialize a new Obsidian vault at a chosen path
- switch the active vault directory during conversation
Example prompts for the agent
- /vault create /Users/name/Notes
- /vault /Users/name/Documents/ObsidianVault
- /vault
How to install vault
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill vault -a claude-code2Manually: put the files in place
~/.claude/skills/vault/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/vault/
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill vault -a codex2Manually: put the files in place
.agents/skills/vault/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill vault -a cursor2Manually: put the files in place
.cursor/skills/vault/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thoreinstein/gemini-obsidian skills/vault2Manually: put the files in place
.github/skills/vault/SKILL.md1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill vault -a gemini-cli2Platform CLI
gemini skills install https://github.com/thoreinstein/gemini-obsidian --path skills/vaultManually: put the files in place
.devin/skills/vault/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about vault
How to install vault in Claude Code?
Run npx skills add thoreinstein/gemini-obsidian --skill vault -a claude-code in your terminal.
What does the vault skill do?
It sets or creates the active Obsidian vault path used by the agent.
What is required when linking an existing vault?
The target folder must already contain a .obsidian directory.
Source text
SKILL.md · ISC
--- name: vault description: >- Use when the user wants to set, change, or create their Obsidian vault, or says "vault", "set vault", "change vault", "create vault", or "new vault". --- # Vault Management Configure or create the Obsidian vault for this session. ## Create New Vault If the user asks to create or initialize a new vault (e.g. `/vault create <path>` or "create vault at <path>"): - Call `obsidian_create_vault` with `path` (and optional `register`, `set_as_current`) - Confirm: "Vault created at: [path]" ## Set Existing Vault Path ### With Argument If the user provides a path to an existing vault after `/vault`: - Call `obsidian_set_vault` with the provided path (it must be an existing Obsidian vault containing a `.obsidian` folder) ### Without Argument If no path is provided: - Ask the user: "What is the absolute path to your Obsidian vault, or would you like to create a new one?" - Once they respond: - If creating: call `obsidian_create_vault` with their path - If setting existing: call `obsidian_set_vault` with their path ## Confirmation After setting, confirm: "Vault path set to: [path]"
© thoreinstein · ISC · thoreinstein/gemini-obsidian