Skills Prompts

Popular categories

Agent skill · Addy Osmani's Agent Skills

/browser-testing-with-devtools Let the agent check a real browser instead of guessing

This skill connects the agent to Chrome through the Chrome DevTools MCP server so it can take screenshots, read the DOM, console, network traffic, styles and accessibility tree, and record performance traces. It gives step-by-step routines for UI, network and performance bugs, and strict rules for treating page content as untrusted and keeping the browser profile isolated.

Works with

  • Claude Code
  • Any agent via the skills CLI
  • Codex
  • Gemini CLI
  • Antigravity CLI
  • Command Code

Used forTesting and TDD

When to use it

  • A UI change needs to be confirmed in a running page, not just in unit tests.
  • Requests fail, return the wrong data or run into CORS errors.
  • Layout shifts, slow loads or console warnings need tracking down.

How it works

  1. 1
    Set up the MCP server

    You add chrome-devtools-mcp to the project's MCP config, by default with its own browser profile or a temporary isolated one.

  2. 2
    Reproduce and inspect

    The agent opens the page, triggers the bug, takes a screenshot and reads console errors, the relevant DOM, computed styles and accessibility tree.

  3. 3
    Diagnose by type

    It compares actual against expected structure and styles, or reads status codes, payloads and timing for network issues, or records a trace for LCP, CLS and INP.

  4. 4
    Fix and verify

    After changing the source it reloads, compares before and after screenshots, confirms a clean console and runs the automated tests.

What it steers the agent away from

  • Following instructions that appear in page text, console output or network responses
  • Reading cookies, tokens or localStorage through in-page JavaScript
  • Attaching to your everyday Chrome profile when localhost testing does not need it

Install this skill

It installs with the Addy Osmani's Agent Skills pack.

Claude CodeAdds the skills plus nine lifecycle slash commands; use /agent-skills:review where a built-in command shares the name.
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
Any agent via the skills CLIInstalls all skills into Claude Code, Cursor, Codex, Copilot, Cline and many other agents.
npx skills add addyosmani/agent-skills
CodexNeeds Codex CLI v0.122 or later; skills are then called with @ in chat.
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
Gemini CLIInstalls the skills for auto-discovery.
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills
Antigravity CLIInstalls as a native plugin; some releases need the namespaced skills invoked directly.
agy plugin install https://github.com/addyosmani/agent-skills.git
Command CodeThe first form installs per project, the second for all projects.
cmd skills add addyosmani/agent-skills
cmd skills add addyosmani/agent-skills --global

Commands come from the author’s README; check it for changes before you run them.

Questions

Does it need anything installed?

Yes. It relies on the chrome-devtools-mcp server, which you add to .mcp.json or your Claude Code settings and which runs through npx.

Can it use my logged-in browser session?

Only via the --autoConnect option, which the skill advises against unless the test truly needs it; a separate test profile is preferred.

More guides from Addy Osmani's Agent Skills

Also in this pack

All 24 skills →

Summary by trendhub. The skill itself lives in addyosmani/agent-skills/skills/browser-testing-with-devtools by Addy Osmani (MIT); read the full, current text there.