Use this skill when source inspection alone is not enough and Codex should operate a live browser.
Default Flow
- Open or reuse a page with
new_pageornavigate_page. - Wait for the relevant UI if needed with
wait_for. - Capture structure with
take_snapshot. - Interact using
uidvalues from the snapshot. - Inspect the relevant evidence surface:
list_console_messagesorget_console_messagefor runtime errorslist_network_requestsorget_network_requestfor API and asset failurestake_screenshotwhen visible state mattersevaluate_scriptfor targeted DOM or app-state checks
- Re-run the smallest verification path after each code change.
Working Rules
- Prefer
take_snapshotover screenshots for navigation and form work. - Take a fresh snapshot after navigation or DOM-changing actions.
- Keep console and network queries filtered or paginated to reduce noise.
- Save large artifacts to disk with
filePathwhen the tool supports it. - If you need an already-running browser session, point the MCP server at it with
--browser-url=...instead of launching a fresh instance.
Common Patterns
- Reproduce a bug: navigate, wait, snapshot, interact, inspect console and network.
- Verify a fix: repeat the exact user path and compare visible state plus console and request results.
- Gather evidence: capture a screenshot, the failing request, and the matching console message.
When Not to Use It
- If the question is purely about static source code and no live browser state matters.
- If the MCP server is running in a restricted mode that does not expose the tools you need.
Source: hashgraph-online/awesome-codex-plugins → plugins/win4r/chrome-devtools-codex-plugin/skills/chrome-devtools/SKILL.md