Productivity
obsidian-vault-ops avatar

obsidian-vault-ops

Manage Obsidian vault operations: file creation, YAML frontmatter, wiki-links, and templated note processing for PKM systems.

Introduction

The obsidian-vault-ops skill provides a comprehensive suite of tools for maintaining and interacting with an Obsidian Personal Knowledge Management (PKM) vault. Designed for users who rely on the 'Goal-Project-Daily' cascade, this skill enables the agent to act as a system librarian and automated executor. It is specifically tailored for environments where file structure, metadata consistency, and inter-note connectivity via wiki-links are paramount to productivity and accountability.

  • File System Management: Supports robust glob-based searching and directory-wide file operations to navigate structured vaults containing Daily Notes, Projects, Goals, and Archives.

  • Metadata and Frontmatter: Automatically maintains YAML frontmatter integrity, ensuring consistent tagging (e.g., #active, #priority/high) and status tracking for tasks and projects.

  • Intelligent Templating: Performs dynamic variable substitution for date-based notes (YYYY-MM-DD), time-stamping, and relative date calculation (date-1, date+1) based on template files.

  • Wiki-Link Maintenance: Handles complex internal linking, including standard [[Note]], aliased [[Note|Display]], and section-specific [[Note#Section]] links to preserve the graph-like structure of the vault.

  • Contextual Awareness: Prioritizes reading the CLAUDE.md vault context file to adhere to user-defined conventions before executing write or edit operations.

  • Automated Hygiene: Facilitates vault maintenance tasks such as fixing broken links, consolidating duplicate notes, and ensuring standard heading hierarchies are preserved during edits.

  • Practical Tips: Always verify the existence of a template before note creation to ensure frontmatter compliance. Use the skill in conjunction with project-specific CLAUDE.md files to respect directory-level organizational rules.

  • Inputs/Outputs: Accepts file paths, search strings, and template identifiers. Returns processed markdown content, file status confirmation, or diagnostic information regarding link integrity.

  • Constraints: Strictly adheres to relative file paths to ensure compatibility with cross-platform Obsidian installations. Designed for Markdown-based storage with no external database dependencies.

Repository Stats

Stars
1,384
Forks
96
Open Issues
11
Language
Shell
Default Branch
main
Sync Status
Idle
Last Synced
Apr 30, 2026, 11:59 AM
View on GitHub