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.