doctor
First-run setup + health check. Verifies Chrome DevTools MCP, installs optional deps (monolith, pptxgenjs, puppeteer), creates working dirs, runs smoke test. Use on fresh clone or when things feel broken.
How do I install this agent skill?
npx skills add https://github.com/bluzir/claude-code-design --skill doctorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a diagnostic and setup utility designed to verify and install development dependencies. It checks for the presence of necessary CLI tools and libraries, creates project directories, and runs a basic smoke test. All installation actions require explicit user consent and utilize standard package managers for well-known libraries.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/bluzir/claude-code-design/doctor">View doctor on skillZs</a>