vault-health

Detect and fix broken links in an Obsidian vault.

2|7|Updated Jun 19, 2026
One-click install
npx skills add https://github.com/humanerd-drew/opencode-drewgent --skill vault-health-humanerd-drew
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-health
Source: https://github.com/humanerd-drew/opencode-drewgent/tree/main/%40action/skills/brain-broken-link-fix
Command: npx skills add https://github.com/humanerd-drew/opencode-drewgent --skill vault-health-humanerd-drew

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill maintains the integrity and health of the .drewgent vault, detects and fixes broken links, and optimizes the Obsidian graph for efficient knowledge management.

Core Features & Use Cases

  • Broken Link Detection: Identifies and corrects broken links within the .drewgent vault.
  • Graph Connectivity Overhaul: Enhances the Obsidian graph's connectivity and structure.
  • Bidirectional Linking: Ensures that links are mutual, improving the integrity of the knowledge graph.
  • Unique Filenames: Enforces unique filenames to prevent broken links and ambiguity.
  • Obsidian Compatibility: Ensures that .neuron files and template variables are compatible with Obsidian.

Quick Start

Run the vault-health skill to check the health of your .drewgent vault and correct any broken links.

Frequently Asked Questions about vault-health

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

FAQPage Schema
How do I detect and fix broken links in an Obsidian vault?

Broken link detection in an Obsidian vault identifies invalid references and corrects them to maintain graph integrity. This skill scans the .drewgent vault, flags broken links, and repairs them to ensure seamless knowledge management connectivity.

What does bidirectional linking do for knowledge management graph optimization?

Bidirectional linking ensures mutual connections between notes, improving graph connectivity and structural integrity. It enforces unique filenames to prevent ambiguity and broken references, creating a highly optimized Obsidian graph for personal knowledge management.

Can I use this to ensure .neuron files and template variables are compatible with Obsidian?

Yes, this skill ensures .neuron files and template variables are fully compatible with Obsidian. It validates these specific file formats and structures during the vault health check, preventing compatibility issues within your personal knowledge management system.

What is the best way to overhaul Obsidian graph connectivity?

The best way to overhaul Obsidian graph connectivity is by detecting broken links, enforcing bidirectional linking, and standardizing unique filenames. This skill restructures the graph to enhance node connections and eliminate isolated notes or ambiguous references.

Why does my Obsidian vault have broken links after renaming files?

Broken links occur when file renames leave orphaned references or create duplicate filenames. This skill resolves these vault health issues by enforcing unique filenames and automatically correcting broken links throughout the entire Obsidian graph.

Do I need a specific vault structure to run vault health checks?

You need an existing Obsidian vault structure, specifically tailored for the .drewgent vault. The skill requires local markdown files to scan for broken links, validate template variables, and optimize graph connectivity without external dependencies.