# Health

> Run vault health check — broken links, orphans, missing sections, statistics. Generates report at 01-index/_graph-health.md. Use for "/health".

- **Type:** Skill
- **Install:** `agentstack add skill-kv0906-pm-kit-health`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kv0906](https://agentstack.voostack.com/s/kv0906)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kv0906](https://github.com/kv0906)
- **Source:** https://github.com/kv0906/pm-kit/tree/main/.claude/skills/health
- **Website:** https://willtran.xyz

## Install

```sh
agentstack add skill-kv0906-pm-kit-health
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# /health — Vault Health Check

Generate comprehensive health report for the vault.

## Context

Config: @_core/config.yaml

## Session Task Progress

```
TaskCreate: "Scan vault files"
  activeForm: "Scanning vault files..."

TaskCreate: "Check links and orphans"
  activeForm: "Validating links..."

TaskCreate: "Generate health report"
  activeForm: "Generating health report..."
```

## Processing Steps

1. **Scan Vault**
   - Glob all `.md` files
   - Exclude: `_core/`, `_templates/`, `_archive/`

2. **Check Broken Links**
   - Extract all `[[wikilinks]]` from each file
   - Verify each target exists
   - Report: source → broken target

3. **Find Orphan Notes**
   - Notes with no inbound links
   - Exclude: index files, standalone: true

4. **Check Missing Sections**
   - Typed notes (doc, decision, blocker, meeting) should have `## Links`
   - Report missing required sections

5. **Calculate Statistics**
   - Notes by type
   - Notes by project
   - Link density (links per note)

6. **Check Synthesis Freshness**
   - For each `01-index/{project}.md`, check if `## Synthesis` section exists
   - If synthesis is missing or says "No synthesis yet", flag as stale
   - Check vault log (`01-index/_vault-log.md`) for last `index-regen` entry per project
   - If no regen in 7+ days, flag as stale

7. **Check Update Status**
   - Read `VERSION` file for local version
   - Query GitHub API for latest release: `curl -sS "https://api.github.com/repos/{repo}/releases/latest"` (non-fatal on failure)
   - Compare: "Up to date" | "Update available: vX → vY" | "Could not check"

8. **Append to Vault Log**
   - Append `health` entry to `01-index/_vault-log.md` (see `.claude/rules/vault-log.md`)

9. **Generate Report**
   - Write to `01-index/_graph-health.md`

## Output Format

```markdown
# Graph Health Report

> Generated: {datetime}

## Broken Links
| Source | Broken Target |
|--------|---------------|
| {path} | [[{target}]]  |

## Orphan Notes
- {path} — no inbound links

## Missing ## Links Sections
- {path} — type: {type}

## Statistics

### By Type
| Type | Count |
|------|-------|
| daily | {n} |
| doc | {n} |

### By Project
| Project | Count |
|---------|-------|
| {proj} | {n} |

### Link Density
- Total links: {n}
- Average per note: {avg}

## Synthesis Health

| Project | Has Synthesis | Last Index Regen | Status |
|---------|---------------|------------------|--------|
| {proj} | Yes/No | {date or "Never"} | Fresh/Stale |

## Framework Status
- **Version**: v{local}
- **Update**: {status — "Up to date" | "Update available: vX → vY" | "Could not check"}

## Actions
1. [ ] Fix broken link: {source} → {target}
2. [ ] Add links to: {orphan}
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kv0906](https://github.com/kv0906)
- **Source:** [kv0906/pm-kit](https://github.com/kv0906/pm-kit)
- **License:** MIT
- **Homepage:** https://willtran.xyz

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kv0906-pm-kit-health
- Seller: https://agentstack.voostack.com/s/kv0906
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.