Health
Run condition-based vault health diagnostics.
Install
npx skills add agenticnotetaking/arscontexta --skill health -g -a claude-code -y- Repository
- agenticnotetaking/arscontexta3.5k
- Category
- Writing
- Updated
- 8mo ago
- License
- MIT
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Run condition-based vault health diagnostics. 8 categories, schema compliance, orphan detection, link health, description quality, three-space boundaries, processing throughput, stale notes, MOC coherence. 3 modes, quick (schema+orphans+links), full (all 8), three-space (boundary violations only). Returns actionable FAIL/WARN/PASS report with specific fixes ranked by impact. Triggers on "/health", "check vault health", "maintenance report", "what needs fixing".
Runtime Configuration (Step 0, before any processing)
Read these files to configure domain-specific behavior:
-
ops/derivation-manifest.md, vocabulary mapping, folder names, platform hints- Use
vocabulary.notesfor the notes folder name - Use
vocabulary.inboxfor the inbox folder name - Use
vocabulary.notefor the note type name in output - Use
vocabulary.topic_mapfor MOC/topic map references - Use
vocabulary.topic_mapsfor plural form
- Use
-
ops/config.yaml, processing depth, thresholds -
Three-space reference,
${CLAUDE_PLUGIN_ROOT}/reference/three-spaces.mdfor boundary rules (load only for full and three-space modes) -
Templates, read template files to understand required schema fields for validation
If these files don't exist (pre-init invocation or standalone use), use universal defaults:
- notes folder:
notes/ - inbox folder:
inbox/ - topic map: topic maps in notes/
EXECUTE NOW
Target: $ARGUMENTS
Parse the invocation mode immediately:
| Input | Mode | Categories Run |
|---|---|---|
empty or quick | Quick | 1 (Schema), 2 (Orphans), 3 (Links) |
full | Full | All 8 categories |
three-space | Three-Space | 5 (Three-Space Boundaries) only |
Execute these steps:
- Detect mode from arguments
- Scan the vault, inventory all note files, {vocabulary.topic_map} files, inbox items, ops files
- Run each applicable diagnostic category in order (1-8)
- Classify each result as PASS, WARN, or FAIL using the thresholds below
- Surface condition-based maintenance signals (check against threshold table)
- Generate the health report with specific file paths, counts, and recommended actions
- Write report to
ops/health/YYYY-MM-DD-report.md
START NOW. Reference below explains each diagnostic category in detail.
