bluzir Doctor
Cold-start health check + optional auto-install. Safe to run multiple times.
Phase 1 — Inventory
Run in parallel where possible:
Bash(claude mcp list)— parse output, look forchrome-devtools: ✓ ConnectedBash(which monolith)— existence checkBash(which node)— requiredBash(which gh)— for/ingest-githubBash(test -f package.json && echo yes || echo no)Bash(test -d starters && echo yes || echo no)— expect yesBash(test -d artifacts && echo yes || echo no)Bash(test -d .claude/skills && echo yes || echo no)— expect yes
Phase 2 — Report
Print structured report:
Chrome DevTools MCP: ✓ / ✗ (if ✗, show install command)
monolith CLI: ✓ / ✗ (optional; needed for /export-standalone)
Node: ✓ / ✗ (required)
gh CLI: ✓ / ✗ (needed for /ingest-github)
package.json: exists / missing
starters/ dir: exists / missing
artifacts/ dir: will create
.claude/skills/: N skills found
FIGMA_TOKEN env: set / not set (only needed for /ingest-figma)
Phase 3 — Repair (with user consent)
For each missing item, ask the user with AskUserQuestion: "Install X now?" (yes/skip/all).
Repair commands (only on yes):
- Chrome DevTools MCP:
Bash(claude mcp add chrome-devtools -s user -- npx chrome-devtools-mcp@latest)— note: requires Claude Code restart to take effect - monolith:
Bash(brew install monolith)(macOS) or tell user for linux - pptxgenjs + puppeteer:
Bash(test -f package.json || npm init -y) Bash(npm install -D pptxgenjs puppeteer) - artifacts/ dir:
Bash(mkdir -p artifacts assets/thumbs test)
Phase 4 — Smoke test
If everything is green (and user didn't just run install → restart):
- Write
test/smoke-deck.html:<!doctype html> <html><head><meta charset="utf-8"/><title>Smoke</title> <script src="../starters/deck_stage.js"></script></head> <body><deck-stage width="1920" height="1080"> <section style="padding:60px;font:48px/1.2 Georgia"><h1>One</h1></section> <section style="padding:60px;font:48px/1.2 Georgia;background:#f4e4d7"><h1>Two</h1></section> <section style="padding:60px;font:48px/1.2 Georgia;background:#4a5d2e;color:#fff"><h1>Three</h1></section> </deck-stage></body></html> - Run
/done test/smoke-deck.html - If Chrome DevTools MCP is connected — check screenshot at
.claude/last-preview.pngexists and console is clean - Report pass/fail
Phase 5 — Hint sheet
Print one-liner hints:
Available commands & skills:
/make-deck <brief> — build a slide deck
/interactive-prototype <brief> — clickable React prototype
/wireframe <thing> — low-fi variants
/create-design-system <src> — extract style guide
/ingest-github <url> — pull tokens from repo
/ingest-screenshot <path> — extract tokens from image
/ingest-figma <url> — pull from Figma (needs FIGMA_TOKEN)
/make-tweakable <html> — add live tweak panel
/apply-tweaks <html> — persist panel changes
/register-asset <html> — add to assets.html overview
/verify-artifact <html> — vision-based QA
/export-pdf /export-pptx /export-standalone /handoff
/preview /done /screenshot — operational atomics