Agent Skills: Obsidian Notes — Understanding the Vault

Obsidian Notes — Understanding the Vault

Provides context about how the user's Obsidian vault is organized so the agent can work with notes effectively — finding, reading, creating, and placing notes in the right location.

Required Capabilities

This skill requires read-only file access to inspect vault documentation and shell access to execute obsidian CLI read commands (such as obsidian vault info=path or obsidian read) or qmd if available. Guide discovery and inspection must remain read-only; do not modify vault guides or notes while gathering context.

Locating the Vault

Determine the vault directory in this order:

1. If already known from memory or conversation context, use that path.
2. Try obsidian vault info=path (requires the obsidian CLI).
3. If the path is unknown, ask the user for the vault directory path.

Reading Vault Guides

Before working with notes, read the vault organization guide from Vault Organization.md and Resources/Frontmatter Conventions.md. These are the single source of truth for folder structure, placement rules, decision logic, frontmatter conventions, and metadata rules per note type. Always read them before creating or organizing notes.

If you have qmd available, use it to query or search notes.