obsidian-vault-ops

Read and write Obsidian vault notes while preserving YAML frontmatter and wiki-links.

1.7k|119|Updated Aug 7, 2025
One-click install
npx skills add https://github.com/ballred/obsidian-claude-pkm --skill obsidian-vault-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-vault-ops
Source: https://github.com/ballred/obsidian-claude-pkm/tree/main/vault-template/.claude/skills/obsidian-vault-ops
Command: npx skills add https://github.com/ballred/obsidian-claude-pkm --skill obsidian-vault-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides core operations for reading, creating, editing, and linking notes inside an Obsidian vault, reducing manual file fiddling and ensuring consistent frontmatter and wiki-links.

Core Features & Use Cases

  • Read and write vault notes while preserving YAML frontmatter and wiki-links
  • Create, update, and organize notes programmatically with proper structure
  • Resolve and manage links between notes to maintain a coherent vault

Quick Start

Open your vault and run a simple operation: read CLAUDE.md for vault context, then create a new note under Daily Notes with a proper frontmatter and wiki-links to related notes.

Frequently Asked Questions about obsidian-vault-ops

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

FAQPage Schema
How do I automate note creation and link management in Obsidian?

Obsidian vault automation enables programmatic note creation, editing, and wiki-link management while preserving YAML frontmatter and vault structure. This Skill reads and writes vault files to handle template-driven creation, frontmatter handling, and link maintenance across related notes like Daily Notes, Projects, and Archives.

Can I read and edit Obsidian files while keeping frontmatter and wiki-links intact?

Yes. This Skill reads and writes Obsidian vault files with YAML frontmatter preservation and wiki-link integrity maintained across operations. It supports Glob pattern file selection and ensures heading hierarchy and standard tag formats remain consistent during edits.

What's the best way to structure and organize Obsidian notes programmatically?

Programmatic note organization uses template-driven creation to establish consistent CLAUDE.md context, Daily Notes, Goals, Projects, Templates, and Archives. This Skill manages the full lifecycle—creating new notes with proper frontmatter, inserting wiki-links between related notes, and maintaining heading hierarchy automatically.

How do I maintain wiki-links between related Obsidian notes automatically?

Wiki-link management resolves and maintains links between notes to preserve vault coherence. This Skill inserts and preserves wiki-links across related notes during read and write operations, keeping your note graph connected as you create and edit content.

Can I use this for Daily Notes, Projects, and other Obsidian vault structures?

Yes. This Skill applies to diverse vault structures including CLAUDE.md context files, Daily Notes, Goals, Projects, Templates, and Archives. It handles template-driven note creation and frontmatter handling consistently across all these organizational patterns.

What happens to markdown formatting and heading structure when I edit notes programmatically?

Heading hierarchy is maintained during all read and write operations. This Skill preserves markdown structure, YAML frontmatter, and wiki-links, ensuring edits don't disrupt your vault's organizational hierarchy or internal link graph.