obsidian-vault

Manage Obsidian vault notes with frontmatter and query by facets.

18|9|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/arozumenko/sdlc-skills --skill obsidian-vault-arozumenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-vault
Source: https://github.com/arozumenko/sdlc-skills/tree/main/skills/obsidian-vault
Command: npx skills add https://github.com/arozumenko/sdlc-skills --skill obsidian-vault-arozumenko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill removes the friction of manually managing an Obsidian vault by letting an agent automatically file incoming signals, create structured notes, and query existing notes using consistent frontmatter.

Core Features & Use Cases

  • Headless Obsidian vault operations: Create, file, and update Markdown notes without running the Obsidian app, using plain filesystem + frontmatter conventions.
  • Structured note lifecycle: Enforce a predictable vault layout (inbox, people, projects, meetings, decisions, etc.) and write the correct schemas via templates.
  • Fast querying for agents and users: Find notes by type, status, tags, person, and project using grep/ripgrep patterns over frontmatter.

Quick Start

Use the obsidian-vault skill to file an incoming chat signal into the vault by providing the vault path in OBSIDIAN_VAULT_PATH and running the command: vault.py file inbox/2026-04-07-anna-question.md --type chat --person "Anna Petrenko" --tag finance

Frequently Asked Questions about obsidian-vault

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically file Markdown notes into an Obsidian vault from the command line?

You can headlessly file Markdown notes into an Obsidian vault using Python CLI scripts that enforce strict vault layout conventions and write consistent frontmatter. This allows automated note filing without opening the Obsidian application.

Can I query Obsidian notes by frontmatter facets like type, status, or tags without the app running?

Yes, you can query Obsidian notes by facets like type, status, tags, person, or project using ripgrep patterns over frontmatter. The system falls back to grep if ripgrep is unavailable.

Do I need Python 3.10 or specific dependencies to manage my Obsidian vault headlessly?

Yes, headless Obsidian vault management requires Python 3.10 or higher and relies on stdlib-only execution, meaning no external Python packages are needed. You also need ripgrep installed for optimal search performance.

What is the best way to triage incoming chat or email signals into structured Obsidian notes?

The best way to triage incoming signals like email, chat, or voice into structured Obsidian notes is by using a headless vault CLI to automatically create specific note types such as people, projects, meetings, and decisions with proper frontmatter.

How does the vault management script handle Obsidian conflict files or sync issues?

The vault management script handles sync issues by strictly refusing to process Obsidian conflict files, ensuring that only clean, non-conflicting Markdown notes are filed, updated, or queried in your knowledge base.