Download for MacApple silicon, macOS 14+
Skill

troubleshooting

@chromedevtools Updated 2026-10-18

Uses Chrome DevTools MCP and documentation to troubleshoot connection and target issues. Trigger this skill when list_pages, new_page, or navigate_page fail, or when the server initialization fails.

browserchromechrome-devtoolsdebuggingdevtoolsmcpmcp-serverpuppeteer

Install

With your agent

Install OMGSkills skill "chromedevtools/chrome-devtools-mcp:troubleshooting" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.

Manual command

git clone https://github.com/ChromeDevTools/chrome-devtools-mcp /tmp/chrome-devtools-mcp && ln -s /tmp/chrome-devtools-mcp/skills/troubleshooting ~/.claude/skills/troubleshooting

From README

Troubleshooting Wizard You are acting as a troubleshooting wizard to help the user configure and fix their Chrome DevTools MCP server . When this skill is triggered (e.g., because listpages, newpage, or navigatepage failed, or the server wouldn't start), follow this step-by-step diagnostic process: Step 1: Find and Read Configuration Your first action should be to locate and read the MCP configuration file. Search for the following files in the user's workspace: .mcp.json, .vscode/mcp.json, gemini-extension.json, or .gemini/settings.json (or user-scoped files such as /.claude.json if accessible). If you find a configuration file, read and interpret it to identify potential issues such as: Incorrect arguments or flags. Missing environment variables. of --autoConnect in incompatible environments. If you cannot find any of these files, only then should you ask the user to provide their configuration file content.