process-vault-frontmatters

Scan Obsidian vault Markdown files and enforce YAML frontmatter fields.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/ramirlm/skillshare-ramir --skill process-vault-frontmatters
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: process-vault-frontmatters
Source: https://github.com/ramirlm/skillshare-ramir/tree/main/process-vault-frontmatters
Command: npx skills add https://github.com/ramirlm/skillshare-ramir --skill process-vault-frontmatters

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, PyYAML, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of ensuring all Markdown notes in an Obsidian vault have consistent and useful YAML frontmatter, preventing redundant processing and improving discoverability.

Core Features & Use Cases

  • Automatic Frontmatter Generation: Creates YAML frontmatter if it doesn't exist.
  • Metadata Standardization: Ensures title (from filename) and summary (from first useful paragraph) fields are populated.
  • Processing Timestamp: Adds or updates a processedAt timestamp to track when a note was last processed.
  • Deduplication Logic: Skips reprocessing notes that haven't been modified since their last processedAt timestamp and already have title and summary.
  • Use Case: Keep your Obsidian vault organized and searchable by automatically adding essential metadata to new and existing notes, ensuring consistency across your knowledge base.

Quick Start

Run the process-vault-frontmatters skill to update your Obsidian vault located at ~/Obsidian.

Frequently Asked Questions about process-vault-frontmatters

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

FAQPage Schema
How do I automatically add YAML frontmatter to Obsidian markdown files?

You can automatically add YAML frontmatter to Obsidian markdown files by recursively scanning your vault to generate missing title and summary fields. This process ensures consistent metadata across all notes without manual editing.

How does the deduplication logic know when to skip reprocessing unmodified notes?

The deduplication logic skips reprocessing unmodified notes by checking a 'processedAt' timestamp against the file's last modification time. It only acts on notes modified after their last processing timestamp that lack required fields.

Do I need Python and PyYAML installed to standardize Obsidian vault metadata?

Yes, you need Python 3 and the PyYAML library installed to standardize Obsidian vault metadata. These dependencies are required for the script to parse existing YAML blocks and generate new frontmatter fields.

What is the best way to ensure my Obsidian vault has consistent title and summary fields?

The best way to ensure consistent title and summary fields is to run an automated script that extracts the title from the filename and the summary from the first useful paragraph. This enforces uniform metadata across your knowledge base.

Can I update the processing timestamp in markdown frontmatter without overwriting existing metadata?

Yes, you can update the 'processedAt' timestamp without overwriting existing metadata. The process intelligently updates only the timestamp and missing fields, preserving your existing valid YAML frontmatter values.