kg-frontmatter

Audit Obsidian vault notes for missing frontmatter fields and auto-fix inferable values.

1.6k|143|Updated Sep 9, 2019
One-click install
npx skills add https://github.com/frutik/awesome-search --skill kg-frontmatter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kg-frontmatter
Source: https://github.com/frutik/awesome-search/tree/main/claude-skills/kg-frontmatter
Command: npx skills add https://github.com/frutik/awesome-search --skill kg-frontmatter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Knowledge graph notes in an Obsidian vault often end up with missing or inconsistent frontmatter fields, which breaks downstream quality checks like orphan detection and entity linking. This Skill scans every note, reports violations by folder, and repairs fields that can be inferred from note content.

Core Features & Use Cases

  • Full-vault frontmatter audit: Scans all notes across Articles, Videos, Concepts, Topics, People, Companies, Tools, Conferences, Case Studies, and Datasets folders against a per-type required-fields table.
  • Structured violation report: Groups missing fields (type, tags, created, source, author, concepts, and more) by folder with counts and note names.
  • Assisted auto-fix: Infers missing values from folder location, file creation date, and note body content, with confirmation prompts or batch mode, and flags un-inferable fields for manual review.
  • Use Case: After importing a batch of new articles into the Awesome Search vault, run the audit to find every note missing source or author, auto-fill what can be inferred, and get a clean list of notes needing manual attention before running other KG quality checks.

Quick Start

Audit all notes in my Awesome Search vault for missing frontmatter fields and fix the ones you can infer.

Frequently Asked Questions about kg-frontmatter

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

FAQPage Schema
How do I check Obsidian notes for missing frontmatter fields?

Run the audit to scan every note in the vault against a required-fields table per note type. It reports missing fields like type, tags, created, source, and author grouped by folder, then optionally auto-fixes values it can infer.

How to auto-fix missing YAML frontmatter in an Obsidian vault?

The skill infers missing values from context: type from the folder, created from the file date, tags from folder and content, and author or source from lines in the note body. It asks for confirmation before writing unless batch mode is approved.

Which frontmatter fields are required for each note type?

All notes require type, tags, and created. Articles additionally need source, author, and concepts; videos need speaker, url, and concepts; topics need related_concepts; case studies need companies, related_concepts, and source; tools and datasets need website or repo where known.

Does the audit access the vault through the filesystem?

No. All vault operations go through the Obsidian MCP server, which is the only sanctioned way to read, search, create, and edit notes. Direct filesystem access via Read, Write, or Bash tools is explicitly disallowed.

Which folders are excluded from the frontmatter audit?

Notes in Clippings/ and raw_articles/ are exempt because they are pre-processing staging areas rather than knowledge graph notes. All other folders such as Articles, Concepts, People, and Tools are fully scanned.

What happens to frontmatter fields that cannot be inferred?

Fields that cannot be reliably inferred, such as concepts for an article with no entity extraction, are flagged in a manual review list. The summary reports how many fields were auto-fixed, how many notes need review, and how many required no action.