Agent skill

Doctor

by bluzir in bluzir/claude-code-design

First-run setup + health check. An agent skill from bluzir/claude-code-design.

No licenceAuto-check passedTesting & QA

Install Doctor

skills CLI
$ npx skills add bluzir/claude-code-design --skill doctor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bluzir/claude-code-design doctor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bluzir/claude-code-design.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/doctor .claude/skills/doctor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
doctor
GitHub stars
106
Token cost
~931 tokens
SKILL.md length
195 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
None found

At a glance

First-run setup + health check. An agent skill from bluzir/claude-code-design.

  • Works in 5 steps: Inventory → Report → Repair (with user consent) → …
  • Tasks that involve Browser testing
  • SKILL.md covers Phase 1 — Inventory, Phase 2 — Report, Phase 3 — Repair (with user… and Phase 4 — Smoke test, plus 1 more section
  • Calls gh and npm; needs FIGMA_TOKEN

What it does

Doctor is an agent skill from bluzir/claude-code-design. 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.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Browser testing and QA and bug reports. It works with Model Context Protocol, Chrome DevTools, Puppeteer and python-pptx. The repository describes itself as: Claude Design reproduced for Claude Code — HTML decks, prototypes, design systems, animated videos via skills + starters + Chrome DevTools MCP.

When your agent uses it

  • Tasks that involve Browser testing
  • Tasks that involve QA and bug reports

Example prompts

  • “/doctor”

Requirements

  • Node.js
  • A credential in FIGMA_TOKEN
  • Pre-approved tools (allowed-tools): Read, Write, Bash(claude:*), Bash(which:*), Bash(brew:*), Bash(npm:*), Bash(node:*), Bash(mkdir:*), Bash(ls:*), Bash(test:*), mcp__chrome-devtools__*

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Inventory
  2. Report
  3. Repair (with user consent)
  4. Smoke test
  5. Hint sheet

What it can do on your machine

Read from SKILL.md and the folder at commit ce68c84. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Bash(claude:*)
    • Bash(which:*)
    • Bash(brew:*)
    • Bash(npm:*)
    • Bash(node:*)
    • Bash(mkdir:*)
    • Bash(ls:*)
    • Bash(test:*)

    …and 1 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FIGMA_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Doctor loads about 931 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 195 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~931

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 195 words (~931 tokens).

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

— opening of SKILL.md by bluzir
name
doctor
allowed-tools
Read, Write, Bash(claude:*), Bash(which:*), Bash(brew:*), Bash(npm:*), Bash(node:*), Bash(mkdir:*), Bash(ls:*), Bash(test:*), mcp__chrome-devtools__*

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/doctor of bluzir/claude-code-design.

Open the folder on GitHubat commit ce68c84

Compare with similar skills

Doctor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Doctor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Doctor this skillbluzir/claude-code-design106—~931Automated safety check: PassNone
Diff-Driven Smoke TestsSkyvern-AI/skyvern23k—~5.2kAutomated safety check: PassAGPL-3.0
Team Frontend Debugcatlog22/Claude-Code-Workflow2.1k—~2.8kAutomated safety check: NotesMIT
Nix Chrome Devtools MCPsrid/emanote963—~271Automated safety check: PassCustom licence
Extension Puppeteer Debuggingmengxi-ream/read-frog10k—~2kAutomated safety check: NotesGPL-3.0
Browser Testing with Chrome DevToolsaddyosmani/agent-skills104k4 repos~3.5kAutomated safety check: WarnMIT

Similar skills

  • Diff-Driven Smoke Tests

    Skyvern-AI/skyvern

    Reads your git diff, writes a handful of happy-path browser smoke tests, runs them with Skyvern or Chrome DevTools MCP and posts screenshot evidence to the PR.

    23k GitHub stars~5.2k tokensUpdated today
    Testing & QAAuto-check passed
  • Team Frontend Debug

    catlog22/Claude-Code-Workflow

    Frontend debugging team using Chrome DevTools MCP. An agent skill from catlog22/Claude-Code-Workflow.

    2.1k GitHub stars~2.8k tokensUpdated 3 mo ago
    Testing & QAAuto-check: notes
  • chrome-devtools-mcp launcher — a single bash script that resolves Playwright's bundled Chrome-for-Testing and Node.js directly through Nix.

    963 GitHub stars~271 tokensUpdated 2 mo ago
    Testing & QAAuto-check passed
  • Extension Puppeteer Debugging

    mengxi-ream/read-frog

    Debug the built Read Frog extension in real Chrome. An agent skill from mengxi-ream/read-frog.

    10k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check: notes
  • Connects an agent to a real Chrome instance through the Chrome DevTools MCP server, so it can inspect the DOM, read console errors and profile performance directly.

    104k GitHub starsUsed in 4 repos~3.5k tokens
    Testing & QAAuto-check: warnings
  • Hands On Test

    ktnyt/cclsp

    Performs manual hands-on testing of a web application using playwright-cli.

    675 GitHub stars~1.7k tokensUpdated 7 mo ago
    Testing & QAAuto-check passed

More from bluzir/claude-code-design

All 18 skills in this repo
  • Apply Tweaks

    bluzir/claude-code-design

    Apply buffered tweaks from pending.yaml to the source HTML file.

    106 GitHub stars~726 tokensUpdated 5 mo ago
    Auto-check passed
  • Copy Example

    bluzir/claude-code-design

    Generate a working demo artifact on dummy content so the user can see a reference implementation.

    106 GitHub stars~782 tokensUpdated 5 mo ago
    Auto-check passed
  • Create Design System

    bluzir/claude-code-design

    Extract or build a design system (tokens, components, style guide).

    106 GitHub stars~1.1k tokensUpdated 5 mo ago
    Auto-check passed
  • Ingest GitHub

    bluzir/claude-code-design

    Clone a GitHub repo and extract design tokens (colors, fonts, spacing) from its codebase.

    106 GitHub stars~796 tokensUpdated 5 mo ago
    Auto-check passed
  • Ingest Screenshot

    bluzir/claude-code-design

    Analyze an uploaded image (screenshot of a design, website, app) and extract design tokens to use as a starting point.

    106 GitHub stars~676 tokensUpdated 5 mo ago
    Auto-check passed
  • Inspect

    bluzir/claude-code-design

    Resolve a natural-language element description ("the red button in the hero", "the third card from the top") to a concrete DOM element in the current preview + source-code location.

    106 GitHub stars~1.1k tokensUpdated 5 mo ago
    Auto-check passed

Categories

Questions about Doctor

What does Doctor do?

First-run setup + health check. An agent skill from bluzir/claude-code-design. Doctor is an agent skill from bluzir/claude-code-design. First-run setup + health check.

When should I use Doctor?

Doctor fits situations like: tasks that involve Browser testing; tasks that involve QA and bug reports.

How do I install Doctor in Claude Code?

Run `npx skills add bluzir/claude-code-design --skill doctor -a claude-code`. Or copy the skill folder (.claude/skills/doctor in bluzir/claude-code-design) into .claude/skills/doctor in your project. Claude Code loads it when a task matches its description.

How do I install Doctor in Codex?

Run `npx skills add bluzir/claude-code-design --skill doctor -a codex`. Or copy the skill folder (.claude/skills/doctor in bluzir/claude-code-design) into .agents/skills/doctor in your project. Codex loads it when a task matches its description.

Can I use Doctor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bluzir/claude-code-design --skill doctor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/doctor, .gemini/skills/doctor, .github/skills/doctor and .opencode/skills/doctor in your project.

What does Doctor need to run?

Going by SKILL.md and its folder, Doctor needs the command-line tools its instructions call (gh and npm) and credentials named FIGMA_TOKEN. Our summary lists: Node.js; A credential in FIGMA_TOKEN. Its frontmatter pre-approves these tools: Read, Write, Bash(claude:*), Bash(which:*), Bash(brew:*), Bash(npm:*), Bash(node:*), Bash(mkdir:*), Bash(ls:*), Bash(test:*), mcp__chrome-devtools__*.

Does Doctor access the network?

SKILL.md contains no URLs. Its commands use gh and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Doctor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Doctor use?

No licence was found for Doctor or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Doctor use?

About 931 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Doctor?

Skills that share tags, products or a category with Doctor: Diff-Driven Smoke Tests (Skyvern-AI/skyvern, 23k stars), Team Frontend Debug (catlog22/Claude-Code-Workflow, 2.1k stars), Nix Chrome Devtools MCP (srid/emanote, 963 stars) and Extension Puppeteer Debugging (mengxi-ream/read-frog, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Doctor?

bluzir (a GitHub user) maintains it in bluzir/claude-code-design, which has 106 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on April 20, 2026.

Source: bluzir/claude-code-design on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.