Ideaverse Maintenance Skill
Run audits, diagnostics, and maintenance workflows to keep Ideaverse-based Obsidian vaults healthy. Assume familiarity with the core Ideaverse methodology.
Requirements
- Python 3.8 or later
- No external dependencies (uses only Python standard library)
Vault Health Diagnostics
Quick Health Check
Preferred (when Obsidian CLI is available):
Obsidian CLI provides native graph diagnostics that are faster and more accurate than script-based analysis:
# Orphan notes (no incoming links)
obsidian orphans
obsidian orphans total
# Dead-end notes (no outgoing links)
obsidian deadends
obsidian deadends total
# Unresolved links (broken wikilinks)
obsidian unresolved
obsidian unresolved total
# Backlinks for a specific note
obsidian backlinks file="Note Name"Use semantic search to suggest connections for orphan notes:
# Find related content for an orphan note
qmd query "summary of the orphan note content"Fallback (Python scripts):
Run these in sequence for a complete vault audit. Scripts can be invoked directly (if executable) or via python3:
# 1. Find broken links (critical)
./scripts/find_broken_links.py /path/to/vault
# or: python3 scripts/find_broken_links.py /path/to/vault
# 2. Find orphan notes (structural)
./scripts/find_orphans.py /path/to/vault
# 3. Check frontmatter compliance (consistency)
./scripts/check_frontmatter.py /path/to/vault
# 4. Detect MOC bloat (scale)
./scripts/detect_moc_bloat.py /path/to/vault
# 5. Find squeeze points (opportunities)
./scripts/validate_squeeze_points.py /path/to/vault
# 6. Suggest archival candidates (hygiene)
./scripts/suggest_archival.py /path/to/vaultNote: Ifpython3is not available on your system, usepythonif it points to Python 3.x.
Script Descriptions
| Script | Purpose | Output |
|---|---|---|
find_broken_links.py | Discover wikilinks pointing to non-existent notes | List of source files with broken links |
find_orphans.py | Identify notes with no incoming links | List of orphan note paths |
check_frontmatter.py | Verify required properties (up, created) | Issues grouped by type |
detect_moc_bloat.py | Find MOCs with 50+ direct links | MOCs sorted by link count |
validate_squeeze_points.py | Find unstructured clusters needing MOCs | Terms linked 10+ times without MOC |
suggest_archival.py | Identify stale notes for archival consideration | Notes sorted by staleness indicators |
All scripts accept a vault path argument and return structured output. Exit code 0 = healthy, 1 = issues found.
Maintenance Cadences
Daily (5 minutes)
- Review today's daily log for unprocessed fleeting notes
- Quick scan for any broken links introduced today
Weekly (15-30 minutes)
- Run
find_broken_links.pyand fix any issues - Run
find_orphans.py- triage: link, archive, or delete - Spot-check frontmatter on recently created notes
Monthly (1-2 hours)
- Full diagnostic suite (all 6 scripts)
- Review MOC bloat - split any MOCs over 50 links
- Process squeeze points - create MOCs where warranted
- Review archival suggestions - archive confirmed stale notes
- Generate and save vault health report
Quarterly (Half day)
- Comprehensive vault audit
- Review and clean Archive folder
- Assess MOC hierarchy - simplify or restructure as needed
- Update any vault-level documentation
Deep Dives
Use reference docs for detailed decision trees, workflows, and maintenance playbooks:
- references/vault-hygiene.md - Hygiene workflows, cadences, and reporting
- references/troubleshooting.md - Diagnosis and resolution guides