obsidian-vault-crud

Perform atomic writes and concurrency-aware access for Obsidian Vault notes.

5|3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill obsidian-vault-crud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-vault-crud
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/obsidian-wiki-engine/skills/obsidian-vault-crud
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill obsidian-vault-crud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safe and reliable disk I/O for Obsidian Vault notes, ensuring atomic writes, advisory locking, and lossless frontmatter handling to prevent data loss during concurrent edits.

Core Features & Use Cases

  • Atomic write and staging via .agent-tmp with secure rename
  • Advisory lock at vault root to coordinate access
  • Conflict detection via mtime checks to avoid overwritten edits
  • Lossless YAML frontmatter preservation using ruamel.yaml
  • Use Case: Update a vault note without risking partial writes or data corruption in multi-process environments.

Quick Start

Use vault_ops.py to create or update a note; the operation will perform atomic writes, advisory locking, and lossless frontmatter handling.

Frequently Asked Questions about obsidian-vault-crud

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

FAQPage Schema
How do I prevent data loss during concurrent edits to Obsidian Vault notes?

Atomic writes prevent data loss during concurrent edits to Obsidian Vault notes by staging changes in a temporary directory and performing a secure rename. Advisory locking coordinates multi-process access to avoid overwriting changes.

How to update YAML frontmatter in Obsidian without losing formatting?

To update YAML frontmatter in Obsidian without losing formatting, use a lossless YAML parser like ruamel.yaml. This preserves the original structure and formatting while allowing you to modify note metadata during create or update operations.

What is an atomic write protocol for vault file I/O?

An atomic write protocol for vault file I/O stages data in a temporary file before securely renaming it to the final path. This ensures the target note is only updated if the entire write operation succeeds, preventing partial or corrupted files.

Does advisory locking work for multi-process Obsidian note access?

Yes, advisory locking works for multi-process Obsidian note access by placing a lock at the vault root. This coordinates concurrent reads, updates, and appends to ensure safe disk I/O and prevent data corruption.

When do I need conflict detection for Obsidian note updates?

You need conflict detection for Obsidian note updates when operating in multi-process environments. It checks file modification times before writing to ensure the note has not changed since it was read, preventing silent data overwrites.