maintenance-agent

Diagnose vault graph health, detect orphan notes, and enforce flat NODES structure.

3|4|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/xrcodexcode/xr_node --skill maintenance-agent-xrcodexcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintenance-agent
Source: https://github.com/xrcodexcode/xr_node/tree/main/claude/skills/maintenance-agent
Command: npx skills add https://github.com/xrcodexcode/xr_node --skill maintenance-agent-xrcodexcode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Knowledge vaults degrade over time as notes accumulate: orphan notes lose all links, wikilinks break, duplicate content fragments the graph, and folder structures drift from their intended flat layout. This Skill automates the detection and reporting of these structural problems so the knowledge base stays navigable and consistent. ## Core Features & Use Cases - Graph Diagnostics: Runs the graph_health.py automation to analyze link connectivity across the vault. - Orphan & Broken Link Detection: Identifies notes with zero inbound or outbound links and flags broken wikilinks. - Structure Enforcement: Scans NODES/ to enforce the flat folder constraint and detects candidate notes for merging. - Use Case: After months of daily note capture, run this Skill to generate a health report listing orphaned notes, broken links, and duplicate candidates so you can repair the graph before it becomes unmanageable. ## Quick Start Ask the agent to run a full vault health check and generate a diagnostic report covering orphan notes, broken links, and NODES folder structure violations.

Frequently Asked Questions about maintenance-agent

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

FAQPage Schema
How do I find orphan notes in my knowledge vault?

Run the maintenance-agent Skill, which executes the graph_health.py automation to scan all notes and identify those with zero inbound or outbound links. The results are compiled into a diagnostic health report listing every orphan note.

How to detect broken wikilinks in a Zettelkasten notes system?

The maintenance-agent Skill scans the vault's link graph and flags wikilinks that point to non-existent notes. Broken links are included in the generated health report alongside orphan notes and duplicate candidates.

Can this Skill enforce a flat folder structure for atomic notes?

Yes, the Skill scans the NODES directory and enforces the flat folder constraint required by the vault architecture. Any notes incorrectly placed in subfolders are flagged in the diagnostic report.

Does the maintenance agent automatically merge duplicate notes?

No, it only detects candidate notes that appear to be duplicates and lists them in the health report. Merging decisions remain manual so no knowledge is lost through automated deletion.

What are the limitations of automated vault health checks?

Automated checks detect structural issues like orphans, broken links, and folder violations, but cannot judge semantic quality or whether a note's content is accurate. Content-level review still requires human or agent judgment.