# Vault Health

> Comprehensive vault diagnostics and health report. Triggers when user mentions "vault health", "health report", "vault diagnostics".

- Skill: `majiayu000/vault-health` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/vault-health`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/vault-health/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/vault-health

---


# Vault Health

Quick vault diagnostics and health assessment.

## When to Use

Invoke when you want to:
- Check overall vault health
- See broken link count
- Identify top hubs (most connected notes)
- Get recommendations for maintenance

## Process

### 1. Get Vault Statistics
Call `mcp__flywheel__get_vault_stats` to retrieve:
- Total notes
- Total links
- Average links per note
- Orphan count
- Broken link count
- Top connected notes (hubs)
- Tag distribution
- Folder breakdown

### 2. Assess Health
Calculate vault health score based on:
- Broken links percentage (lower is better)
- Orphan percentage (lower is better)
- Average connectivity (higher is better)
- Link growth trend

### 3. Generate Report
Format comprehensive health report:

```
Vault Health Report
═══════════════════════════════════════════════
📊 Overview:
  • Total Notes: 1,000
  • Total Links: 15,000
  • Average Links/Note: 15.0

⚠️ Issues Found:
  • Broken Links: 200 (1.3% of all links)
  • Orphan Notes: 100 (10% of all notes)

🌟 Top Hubs:
  1. [[Project A]] - 150 backlinks
  2. [[Technology X]] - 120 backlinks
  3. [[Daily Workflow]] - 100 backlinks

📈 Vault Health Score: 85% (Good)

💡 Recommendations:
  • Run /vault-fix-links to repair broken links
  • Review /orphans to connect isolated notes
═══════════════════════════════════════════════
```

### 4. Provide Action Items
Link to relevant skills based on issues found:
- Many broken links → Suggest `/vault-fix-links`
- Many orphans → Suggest `/orphans`
- Low connectivity → Suggest `/suggest` for link suggestions

## Health Score Calculation

```
Base Score: 100%

Deductions:
- Broken links: -0.5% per 1% of total links broken
- Orphans: -0.3% per 1% of notes orphaned
- Low connectivity: -10% if avg < 5 links/note

Bonuses:
- High connectivity: +5% if avg > 15 links/note
- Few orphans: +5% if orphan% < 10%
- Few broken: +5% if broken% < 5%

Final Score: 0-100%
  90-100%: Excellent ✅
  75-89%: Good 👍
  60-74%: Fair ⚠️
  <60%: Needs Attention 🚨
```

## Output Format

Always use the branded format:

```
Vault Health Report
═══════════════════════════════════════════════

[Report content here]

═══════════════════════════════════════════════
```

## Performance

- **Speed**: 2-3 seconds (single MCP call)
- **Accuracy**: 100% (direct from Flywheel MCP)
- **Caching**: None needed (live data)