Agent skill

Inspect

by bluzir in 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.

No licenceAuto-check passedTesting & QA

Install Inspect

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

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

GitHub CLI
$ gh skill install bluzir/claude-code-design inspect --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/inspect .claude/skills/inspect && 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
inspect
GitHub stars
106
Token cost
~1.1k tokens
SKILL.md length
411 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
None found

At a glance

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.

  • Works in 6 steps: Get snapshot → Match the description against snapshot… → Pick the best UID. If multiple… → …
  • User asks to change/style/remove a specific visual element without pointing at source code
  • SKILL.md covers Prerequisites, Pipeline, Heuristic priorities for "the… and When to fall back to asking, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Inspect is an agent skill from 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. Uses Chrome DevTools MCP takesnapshot UIDs for deterministic targeting. Use when user asks to change/style/remove a specific visual element without pointing at source code.

Its SKILL.md is about 1.1k 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. It works with Model Context Protocol and Chrome DevTools. 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

  • User asks to change/style/remove a specific visual element without pointing at source code
  • Tasks that involve Browser testing

Example prompts

  • “the red button in the hero”
  • “the third card from the top”
  • “/inspect”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob, mcp__chrome-devtools__take_snapshot, mcp__chrome-devtools__evaluate_script, mcp__chrome-devtools__take_screenshot

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Get snapshot
  2. Match the description against snapshot nodes. Use vision + text heuristics
  3. Pick the best UID. If multiple candidates, show the top 3 to the user with a one-line summary each
  4. Resolve to source location. Once UID is confirmed
  5. Report
  6. Optional next step: if user requested an edit alongside inspection ("make it bigger") — perform the Edit directly with the located line…

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
    • Grep
    • Glob
    • mcp__chrome-devtools__take_snapshot
    • mcp__chrome-devtools__evaluate_script
    • mcp__chrome-devtools__take_screenshot

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Inspect loads about 1.1k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 411 words of instructions outside code blocks.

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

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 411 words (~1,070 tokens).

“Replaces Claude Design's inline-comment protocol with a terminal-native alternative: user describes an element in English, Claude resolves to a specific DOM node + source location for surgical edits.”

— opening of SKILL.md by bluzir
name
inspect
allowed-tools
Read, Grep, Glob, mcp__chrome-devtools__take_snapshot, mcp__chrome-devtools__evaluate_script, mcp__chrome-devtools__take_screenshot
argument-hint
<natural-language description>

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit ce68c84

Compare with similar skills

Inspect 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.

Inspect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Inspect this skillbluzir/claude-code-design106—~1.1kAutomated safety check: PassNone
Browser Testing with Chrome DevToolsaddyosmani/agent-skills103k4 repos~3.5kAutomated safety check: WarnMIT
Diff-Driven Smoke TestsSkyvern-AI/skyvern23k—~5.2kAutomated safety check: PassAGPL-3.0
System Bridge Testing Workflowtimmo001/system-bridge356—~843Automated safety check: PassApache-2.0
Mirroir Onboardjfarcand/mirroir-mcp245—~4.4kAutomated safety check: NotesApache-2.0
Capture Bannersnguyenyou/scalex109—~586Automated safety check: PassMIT

Similar skills

  • 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.

    103k GitHub starsUsed in 4 repos~3.5k tokens
    Testing & QAAuto-check: warnings
  • 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
  • System Bridge Testing Workflow

    timmo001/system-bridge

    How to test System Bridge - Go table-driven tests and commands, web-client quality checks (lint/typecheck/format, no unit tests), the Chrome DevTools MCP interactive test loop for UI and WebSocket…

    356 GitHub stars~843 tokensUpdated today
    Testing & QAAuto-check passed
  • Mirroir Onboard

    jfarcand/mirroir-mcp

    Onboard a consumer web app to mirroir's .mirroir/ dotfile by EXPLORING the running app (chrome-devtools-mcp) — derive real selectors from the accessibility tree, exercise each surface's primary…

    245 GitHub stars~4.4k tokensUpdated 3 days ago
    Testing & QAAuto-check: notes
  • Capture Banners

    nguyenyou/scalex

    Re-render Scalex banner and OG image PNGs from their HTML source files using Chrome DevTools MCP.

    109 GitHub stars~586 tokensUpdated 20 days ago
    Testing & QAAuto-check passed
  • Octocode Chrome Devtools

    bgauryy/octocode

    A skill your agent uses when a live page needs Chrome DevTools/CDP evidence: network failures, console errors, performance, DOM/CSS actionability, screenshots/PDF, cookies/storage…

    949 GitHub stars~1.6k tokensUpdated 5 days 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
  • Make Deck

    bluzir/claude-code-design

    Build an HTML slide deck (1920×1080, keyboard nav, exportable) when user asks for a presentation, pitch deck, slides, or keynote.

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

Categories

Questions about Inspect

What does Inspect do?

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. Inspect is an agent skill from 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.

When should I use Inspect?

Inspect fits situations like: user asks to change/style/remove a specific visual element without pointing at source code; tasks that involve Browser testing.

How do I install Inspect in Claude Code?

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

How do I install Inspect in Codex?

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

Can I use Inspect 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 inspect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/inspect, .gemini/skills/inspect, .github/skills/inspect and .opencode/skills/inspect in your project.

What does Inspect need to run?

SKILL.md names no scripts, command-line tools or credentials: Inspect is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob, mcp__chrome-devtools__take_snapshot, mcp__chrome-devtools__evaluate_script, mcp__chrome-devtools__take_screenshot.

Does Inspect access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Inspect 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 Inspect use?

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

How many tokens does Inspect use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Inspect?

Skills that share tags, products or a category with Inspect: Browser Testing with Chrome DevTools (addyosmani/agent-skills, 103k stars), Diff-Driven Smoke Tests (Skyvern-AI/skyvern, 23k stars), System Bridge Testing Workflow (timmo001/system-bridge, 356 stars) and Mirroir Onboard (jfarcand/mirroir-mcp, 245 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Inspect?

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.