maintain

Vault Maintenance

Read-only health audit. Diagnoses issues across four dimensions: wiki quality, link integrity, tag consistency, and overall stats. Reports findings with prioritized fixes — then waits for the user to decide what to act on.

Never modify a note without an explicit "fix this" instruction.

This skill checks integrity (links, tags, wiki quality). For PARA structure on Projects and Areas — stalled projects, missing outcomes/deadlines, done-but-not-archived — use audit-para.

Step 1 — Wiki Lint (3 - Resources/ layer)

Audit the wiki layer before structural checks. Six checks:

W1. Orphan wiki pages — pages with source: claude-memory frontmatter that have zero inbound links:

obsidian orphans

W2. Concepts without pages — scan index.md and wiki pages for concept names mentioned in prose but lacking their own page in 3 - Resources/.

W3. Contradictions — read pairs of related wiki pages in 3 - Resources/Coding/ and 3 - Resources/Concepts/. Flag conflicting claims.

W4. Stale sources — check index.md Articles/Videos/Tweets entries. Flag sources older than 6 months whose wiki pages may need revisiting.

W5. Sources not in index — files in 3 - Resources/Articles/, 3 - Resources/Tweets/, 3 - Resources/Videos/ not listed in index.md:

obsidian files folder="3 - Resources/Articles/" format=json
obsidian files folder="3 - Resources/Tweets/" format=json
obsidian files folder="3 - Resources/Videos/" format=json

Cross-check each against index.md sections.

W6. Missing cross-references — related concept pages that don't link each other. Use obsidian search on page titles to find semantic neighbors, check if wikilinked.

After wiki lint, append findings summary to log.md (chronological — append is fine):

obsidian append path="3 - Resources/log.md" content="\n## $(date +%Y-%m-%d)\nlint | <summary of findings>"

Step 2 — Link Health

For deep link analysis, delegate to the link-maintainer agent which handles the 2-Link Rule and unlinked mention checks. For a quick check:

obsidian unresolved verbose counts
obsidian orphans total
obsidian deadends total

Capture:

• Count of broken/unresolved links
• Count of orphaned notes (no inbound links)
• Count of dead-end notes (no outgoing links)
• Most-linked-to missing targets (high-impact fixes first)

Step 3 — Tag Consistency

For deep tag analysis, delegate to the tag-optimizer agent. For a quick check:

obsidian tags counts sort=count

Scan for:

• Redundant tags: tags that duplicate folder location (e.g., #project on a note already in 1 - Projects/)
• Notes exceeding 4-tag limit: more than 4 tags is a signal of unclear categorization
• TIL notes missing til/ prefix: any tags in 3 - Resources/TIL/ notes that don't follow the til/<tech> convention
• Tags to consolidate: near-duplicates (js → javascript)

Step 4 — Stats

Run all in parallel:

obsidian vault info=files
obsidian tasks todo total
obsidian orphans total
obsidian deadends total
obsidian unresolved total

Report Format

Vault Health Check Complete!

Wiki Lint: X issues
- W1 Orphan wiki pages: X
- W2 Concepts without pages: X
- W3 Contradictions: X
- W4 Stale sources: X
- W5 Sources not in index: X
- W6 Missing cross-references: X

Link Health: X broken | X orphans | X dead ends
Tag Health:  X redundant | X over-limit | X missing til/

Stats: X files | X orphans | X dead ends | X broken links
       X outstanding tasks (Projects: X)

Overall: Good / Needs Attention / Critical
Priority fixes: [top 3 issues]

Health thresholds:

• Good: < 10 total issues
• Needs Attention: 10–30 issues
• Critical: > 30 issues or many broken links in active notes

After the report, ask: "Want me to fix any of these?" Only then act.

References

Load when	Reference
Need weekly/monthly/quarterly maintenance checklists	references/maintenance-checklists.md