Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add thoreinstein/gemini-obsidian --skill vault -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/vault/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/vault/

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

Similar skills

All skills for Notes, tasks and projects →

From the same set15

The whole set →
index Triggers indexing of an Obsidian vault for semantic search — incremental by default, full rebuild when you ask for force. CX Codex +1 ★ 102repo stars links links is a Claude Code skill that maps connections around a note. It activates for requests about backlinks, linked notes, or a note graph. CX Codex +1 ★ 102repo stars librarian librarian audits an Obsidian vault’s folders, frontmatter, links, and tags. Use it to plan cleanup before changing where notes live. CX Codex +1 ★ 102repo stars researcher researcher — a subagent that digs through an Obsidian vault: chains semantic search, full note reads and wikilink hops, then answers with note citations. CX Codex +1 ★ 102repo stars research research is a Claude Code skill that searches an Obsidian vault, reads relevant notes, and follows links to answer questions about stored knowledge. CX Codex +1 ★ 102repo stars moc-update moc-update finds the Maps of Content (MOCs) in an Obsidian vault that should link to a freshly created Engineering/ note. Fires on prompts like “update MOC” or “which MOCs”. CX Codex +1 ★ 102repo stars link-audit link-audit audits Obsidian vaults for broken wikilinks and orphaned notes. Helps repair target paths or generate new links via semantic search. CX Codex +1 ★ 102repo stars knowledge This skill finds ideas repeated across project notes and drafts a shared note in Engineering/. Use it to turn recurring project knowledge into a linked concept. CX Codex +1 ★ 102repo stars

Project sponsors

Companies that keep this analytics open