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.