obsidian-vault

Read, create, edit, and reorganize Markdown notes inside local Obsidian vaults.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/AarnavBaddam/skills --skill obsidian-vault-aarnavbaddam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-vault
Source: https://github.com/AarnavBaddam/skills/tree/main/obsidian-vault
Command: npx skills add https://github.com/AarnavBaddam/skills --skill obsidian-vault-aarnavbaddam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing an Obsidian vault with generic file tools often breaks wikilinks, YAML frontmatter, embeds, and folder conventions. This Skill lets an AI work directly on vault Markdown files while preserving Obsidian-specific syntax and structure. ## Core Features & Use Cases - Syntax Preservation: Keeps YAML frontmatter, wikilinks like [[Note]], embeds like ![[image.png]], tags, callouts, task lists, and block IDs intact during edits. - Vault-Aware Workflows: Supports reading and summarizing notes, creating notes that match existing naming and folder conventions, making minimal targeted edits, and safely moving or renaming notes with inbound link updates. - Configuration Handling: Treats the .obsidian directory as configuration, changing workspace, plugin, hotkey, or appearance settings only when explicitly requested. - Use Case: Ask the AI to rename a heavily linked note; it first searches for inbound references, updates affected wikilinks, and moves the file without breaking the graph. ## Quick Start Use the obsidian-vault skill to create a new meeting note in my vault's Meetings folder following the existing note conventions.

Frequently Asked Questions about obsidian-vault

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

FAQPage Schema
How do I edit Obsidian notes without breaking wikilinks?

Edit the Markdown files directly while preserving wikilink syntax like [[Note]] and aliases like [[Note|Alias]]. When renaming a note, first search the vault for inbound references and update those links so the note graph stays intact.

How to create a new Obsidian note that matches my vault conventions?

Inspect nearby notes and templates in the target folder, then reuse their naming style, YAML frontmatter fields, and structure. If the destination folder is unclear and no convention exists, confirm the location before creating the file.

Can this skill control the Obsidian app directly?

No, it works only on vault files stored on the filesystem, not on the live Obsidian application. It can edit Markdown notes and .obsidian configuration files, but it cannot automate the app's UI or running instance.

Is it safe to edit .obsidian configuration files?

Yes, but treat .obsidian as configuration rather than content. Change workspace, plugin, hotkey, or appearance settings only when explicitly requested, and prefer small targeted edits over regenerating entire config files.

What happens when renaming a note with many inbound links?

The skill searches the vault for references to the old note name before renaming, then updates affected wikilinks and explicit Markdown links that are in scope. Risky operations that could break many links are flagged before proceeding.