Healthcheck
Read-only vault health diagnostic.
Install
npx skills add ccplugins/awesome-claude-code-plugins --skill healthcheck -g -a claude-code -y- Repository
- ccplugins/awesome-claude-code-plugins991
- Category
- Engineering
- Updated
- 3mo ago
- License
- Apache-2.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Read-only vault health diagnostic. Generates a report without modifying any files. Checks: graphify-out integrity, setup verification, orphan entities, dangling content, old content (>15 days). Safe to run at any frequency. Use when: "bedrock healthcheck", "bedrock-healthcheck", "vault health", "check vault", "vault status", "/bedrock:healthcheck".
/bedrock:healthcheck, Vault Health Report
Plugin Paths
Entity definitions and templates are in the plugin directory, not the vault root. Use the "Base directory for this skill" provided at invocation to resolve paths:
- Entity definitions:
<base_dir>/../../entities/ - Templates:
<base_dir>/../../templates/{type}/_template.md - Plugin CLAUDE.md:
<base_dir>/../../CLAUDE.md(already injected automatically into context)
Where <base_dir> is the path provided in "Base directory for this skill".
Vault Resolution
Resolve which vault to diagnose. This skill can be invoked from any directory.
Step 1, Parse --vault flag:
Check if the input arguments include --vault <name>. If found, extract the vault name.
Step 2, Resolve vault path:
-
If
--vault <name>was provided: Read the vault registry at<base_dir>/../../vaults.json. Find the entry matching the name. If not found: error, "Vault<name>is not registered. Run/bedrock:vaultsto see available vaults." If found: setVAULT_PATHto the entry'spathvalue. -
If no
--vaultflag, CWD detection: Read<base_dir>/../../vaults.json. Check if the current working directory is inside any registered vault path (CWD starts with a registered vault's absolute path). If multiple match, use the longest path (most specific). If found: setVAULT_PATHto the matching vault'spath. -
If CWD detection fails, default vault: From the registry, find the vault with
"default": true. If found: setVAULT_PATHto the default vault'spath. -
If no resolution: Error, "No vault resolved. Available vaults:" followed by the registry listing. "Use
--vault <name>to specify, or run/bedrock:setupto register a vault."
Step 3, Validate vault path:
test -d "<VAULT_PATH>" && echo "exists" || echo "missing"
If missing: error, "Vault path <VAULT_PATH> does not exist on disk. Run /bedrock:setup to re-register."
