kg-audit

Audits an Obsidian knowledge graph vault for frontmatter violations, orphans, duplicates, and broken wikilinks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Maintaining a large Obsidian knowledge graph (800+ notes) means frontmatter drift, orphan notes, duplicate articles, disconnected clusters, and broken wikilinks accumulate silently, and running four separate full-vault scans to find them is too slow for routine health checks.

Core Features & Use Cases

  • Single-Pass Audit: Runs scripts/kg_audit.py once over the vault to compute frontmatter completeness, orphan detection, hub ranking, topic coverage, connected components, duplicate sources, and unresolved wikilinks in one read.
  • Duplicate Article Detection: Groups Articles and Videos by their source/url frontmatter field to surface the same real-world article processed into two separate notes.
  • Structured JSON Reporting: Writes full findings to a gitignored JSON file and prints a one-line summary, which the skill turns into prioritized, pattern-grouped reports.
  • Use Case: After a large batch of note-writing runs, ask for a vault audit to catch systemic issues like an entire folder missing a required field or duplicate notes splitting inbound links.

Quick Start

Ask the assistant to audit the vault or run a KG health check, and it will execute the audit script and report duplicates, frontmatter violations, orphans, and broken links in priority order.

Frequently Asked Questions about kg-audit

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

FAQPage Schema
How do I audit an Obsidian vault for broken links and orphans?

Run the kg_audit.py script against the vault root; it parses every markdown note once, builds a wikilink graph, and reports orphan notes, unresolved wikilinks, and disconnected components as structured JSON.

How to find duplicate notes in an Obsidian knowledge graph?

The script groups Articles and Videos notes by their source or url frontmatter field. Any group with two or more notes is the same real-world article processed twice, often with different titles and split inbound links.

Does the audit script modify my Obsidian vault files?

No, the script is strictly read-only and writes nothing to the vault. It only outputs a JSON report to a gitignored scratchpad path, and any fixes must be applied separately through the Obsidian MCP server or related skills.

Why use one audit script instead of separate frontmatter and orphan checks?

At 800+ notes, reading every file four separate times through MCP round-trips is too slow for routine checks. A single filesystem pass computes all metrics at once, making periodic health checks practical.

What frontmatter fields does the vault audit validate?

It checks base fields (type, tags, created) plus type-specific requirements, such as source/author/concepts for articles, website for companies, and related_concepts for topics, based on the folder each note lives in.