mcpField
D
doctor

doctor

github.com/bluzirDevelopment10748 installsUpdated 28w ago
Repository

About doctor

A cold-start health-check skill for a development project, with optional repairs that require user consent. It inventories tools and project files, runs a smoke test, and prints available command and skill hints.

Key features

  1. 01Check installed tools and project files
  2. 02Report missing dependencies and directories
  3. 03Offer repairs with user consent
  4. 04Run a smoke test
  5. 05Print available commands and skills

Use cases

  1. 01Checking project readiness after a cold start
  2. 02Finding missing tools before development
  3. 03Installing selected dependencies with consent
  4. 04Verifying a generated slide deck workflow

MCP support

Checks whether Chrome DevTools MCP is connected and provides a Claude Code command to add it if missing. A restart is required for the installation to take effect.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bluzir/claude-code-design --skill doctor

After installing, type/doctorin Claude Code to confirm it loaded.

Details

From the project README

Doctor

Cold-start health check + optional auto-install. Safe to run multiple times.

Phase 1 — Inventory

Run in parallel where possible:

  1. Bash(claude mcp list) — parse output, look for chrome-devtools: ✓ Connected
  2. Bash(which monolith) — existence check
  3. Bash(which node) — required
  4. Bash(which gh) — for /ingest-github
  5. Bash(test -f package.json && echo yes || echo no)
  6. Bash(test -d starters && echo yes || echo no) — expect yes
  7. Bash(test -d artifacts && echo yes || echo no)
  8. 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):

  1. 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>
  2. Run /done test/smoke-deck.html
  3. If Chrome DevTools MCP is connected — check screenshot at .claude/last-preview.png exists and console is clean
  4. 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

Comments

Markdown supported