Healthcheck

Skill BULDEE/ai-craftsman-superpowers/skills/healthcheck

Run a comprehensive diagnostic of your Craftsman plugin installation and runtime. Use when troubleshooting plugin issues, after setup, or when session-start reports warnings.From its SKILL.md

Install

npx -y skills add BULDEE/ai-craftsman-superpowers --skill healthcheck

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.0 KB, as published. Nobody here has run it

/craftsman:healthcheck - Plugin Diagnostic

Outcome Contract

Outcome: a diagnostic of the plugin installation and runtime, with each failing check tied to a fix.
Done when: every check reports ok, warn, or error; each non-ok check names the action that resolves it.
Evidence: the healthcheck output itself, with counts.

Run a full health check of your AI Craftsman Superpowers installation.

Process

Run the healthcheck script using the Bash tool:

source "${CLAUDE_PLUGIN_ROOT}/hooks/lib/config.sh" && \
source "${CLAUDE_PLUGIN_ROOT}/hooks/lib/pack-loader.sh" && \
pack_loader_init 2>/dev/null && \
source "${CLAUDE_PLUGIN_ROOT}/hooks/lib/healthcheck.sh" && \
hc_json

Parse the JSON output and present each check with its status:
- ok → display with checkmark
- warn → display with warning and actionable message
- error → display with error and fix instructions
Format as a clear diagnostic report:

╭─ Craftsman Healthcheck ─────────────────────╮
│                                              │
│  [check name]     [status icon] [message]   │
│  ...                                         │
│                                              │
│  Status: ALL GREEN / N issues found          │
╰──────────────────────────────────────────────╯

If any checks fail, provide specific fix instructions:
- missing deps → brew install <dep> (macOS) or apt-get install <dep> (Linux)
- missing config → Run /craftsman:setup
- Knowledge DB empty → /craftsman:knowledge sync
- Channels open → /craftsman:healthcheck will show cooldown status

SKILL.md

/craftsman:healthcheck - Plugin Diagnostic

Outcome Contract

Process

Keep looking