| name | audit |
| description | Scan agent-maintained directories for health issues: orphan pages, broken wikilinks, stale content, frontmatter violations, tag taxonomy drift, oversized pages. Use this skill whenever the user wants to audit knowledge base quality, check for broken links, find stale or orphan pages, or says anything like "check my wiki", "are there any issues", "audit the knowledge base", "find broken links", or "what needs fixing".
|
/audit — Knowledge Health Check
Scan the four agent-maintained directories (entities/, concepts/, comparisons/, queries/)
for structural issues.
Use the deterministic tools first — they compute several categories exactly:
obsidian orphans
obsidian unresolved
obsidian deadends
obsidian knowlery:stale
If the knowlery MCP stale tool is present, prefer it for categories 3 and 7 —
same report, no shell needed.
Filter tool output to the four agent directories. Fall back to manual traversal only
when none of the tools is available.
Scan Categories
1. Orphan Pages
Pages with no inbound wikilinks from any other note — from obsidian orphans.
- Severity: warning for new pages (< 7 days old), info for older
2. Broken Wikilinks
Wikilinks in agent pages that point to non-existent targets — from obsidian unresolved.
3. Stale Content
Compiled pages whose cited sources changed after the page was last written — the
Stale pages section of the staleness report.
4. Frontmatter Violations
Pages missing required fields (title, date, created, updated, type, tags, sources).
- Severity: warning for missing required fields
5. Tag Taxonomy Drift
Tags used in agent pages that are not defined in SCHEMA.md.
6. Oversized Pages
Pages exceeding ~200 lines — candidates for splitting.
7. Dangling Sources
Agent pages whose sources cite notes that no longer exist — the Dangling sources
section of the staleness report.
Report Format
Group findings by severity:
Health check complete. Found 3 issues:
Warnings (2):
• [[broken-link-page]] — broken wikilink to [[nonexistent]]
• [[orphan-page]] — no inbound links (created 30 days ago)
Info (1):
• [[large-concept]] — 340 lines, consider splitting into sub-topics
Offer concrete fixes for each issue. Ask before making changes.
