skills.rest
mrfelton
mrfeltonCOMMUNITY
Explore all skills by this author →
Website𝕏@mrfeltonGitHub

ideaverse-maintenance

Run six Python scripts to diagnose broken links, orphans, and frontmatter in Ideaverse vaults.

16|2|Updated Jan 31, 2026
Search Tags:#maintenance#archival#diagnostics#frontmatter#audits#MOC#vault-health
One-click install
npx skills add https://github.com/mrfelton/ideaverse --skill ideaverse-maintenance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ideaverse-maintenance
Source: https://github.com/mrfelton/ideaverse/tree/main/skills/ideaverse-maintenance
Command: npx skills add https://github.com/mrfelton/ideaverse --skill ideaverse-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Keep Ideaverse vaults healthy by performing routine audits and maintenance workflows. This skill helps identify broken links, orphan notes, frontmatter drift, MOC bloat, and archiving opportunities, ensuring a robust and navigable knowledge base.

Core Features & Use Cases

  • Automated vault diagnostics: run the six scripts (find_broken_links, find_orphans, check_frontmatter, detect_moc_bloat, validate_squeeze_points, suggest_archival) to produce a health report.
  • Structural hygiene: detect MOC bloat, squeeze points, and orphan notes to improve navigation and structure.
  • Compliance and governance: verify frontmatter integrity and ensure vault-level consistency across notes.
  • Use case: After migrating a vault, run the maintenance suite to surface and fix gaps, then generate a vault health report for stakeholders.

Quick Start

Run the maintenance workflow against your vault path by executing the six scripts in order against the root vault directory, for example: find_broken_links.py /path/to/vault; find_orphans.py /path/to/vault; check_frontmatter.py /path/to/vault; detect_moc_bloat.py /path/to/vault; validate_squeeze_points.py /path/to/vault; suggest_archival.py /path/to/vault.

Frequently Asked Questions about ideaverse-maintenance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find broken links and orphan notes in my vault?▼

You can identify broken links and orphan notes by executing the find_broken_links.py and find_orphans.py scripts against your root vault directory. This maintenance workflow surfaces navigation gaps and disconnected content for structural repair.

What is frontmatter compliance and how do I check it?▼

Frontmatter compliance verifies metadata integrity and consistency across notes. You check it by running the check_frontmatter.py script against your vault path to detect metadata drift and ensure vault-level governance standards are met.

How do I detect MOC bloat and validate squeeze points?▼

You detect MOC bloat and validate squeeze points by executing the detect_moc_bloat.py and validate_squeeze_points.py scripts. These diagnostics target structural hygiene issues, helping improve navigation and correct structural congestion in your knowledge base.

Does this vault maintenance workflow require external Python dependencies?▼

No external dependencies are required. The vault maintenance suite needs Python 3.8+ and relies solely on the standard library, utilizing six scripts and a small vault_utils module to execute audits and generate health reports.

What's the best way to audit vault health after a migration?▼

To audit vault health after a migration, execute the six maintenance scripts in order against the root vault directory. This workflow surfaces broken links, frontmatter drift, and archival opportunities, producing a comprehensive health report for stakeholders.

Can I automate archival suggestions for inactive notes?▼

Yes, you can automate archival suggestions by running the suggest_archival.py script against your vault directory. This maintenance task identifies archival opportunities across your Ideaverse vault, helping you archive inactive notes and maintain a navigable structure.

Related Skills

Explore More Software Engineering Skills→
tentacle-protentacle-pro
4

tentacle-skills-washing

Adapt downloaded Python and TypeScript skills to vault runtime conventions.

Community
Intermediate
Mark393295827Mark393295827
133

wiki-lint

Audit markdown wikis for broken links, orphan pages, and frontmatter gaps.

Community
Advanced
DavidROliverBADavidROliverBA
49

/orphans

Identify and report notes without incoming backlinks in a knowledge base.

Community
Advanced
lehuuhau1231lehuuhau1231

lint-and-validate

Run linting and type checking across multiple programming ecosystems.

Community
Intermediate