What does this skill do?

The Troubleshooting skill acts as an interactive diagnostic assistant for resolving Chrome DevTools MCP server configuration and connection problems.

It triggers when operations like list_pages, new_page, or navigate_page fail, or when server initialization fails, and works through a structured diagnostic sequence.

It discovers configuration files, triages common errors, consults known issues, formulates corrected configuration for the user's environment, and runs diagnostics to verify a working connection.

  • Discovers and validates MCP configuration files

  • Triages common connection and target errors

  • Produces corrected configuration for the environment

  • Runs diagnostics to confirm a working connection

How it works

1

Discover configuration

The agent searches the workspace for MCP configuration files and analyzes them for incorrect arguments or missing variables.

2

Triage the error

It classifies common errors — DevToolsActivePort, empty page lists, limited tools, missing extension tools — to likely causes.

3

Formulate the fix

It consults known issues and provides corrected MCP configuration based on the user's OS and environment.

4

Run diagnostics

It runs diagnostic commands and verbose logging, and verifies a successful connection via the list_pages tool.

Best use cases for this skill

  • Connection failures: Diagnose failed list_pages, new_page, or navigate_page operations.

  • Server startup: Resolve Chrome DevTools MCP server initialization failures.

  • Config fixes: Correct MCP configuration for the user's OS and environment.

  • Diagnostics: Capture detailed logs to isolate the root cause.

Frequently asked questions

What does the Troubleshooting skill do?

It uses Chrome DevTools MCP and documentation to troubleshoot connection and target issues — discovering configuration, triaging errors, and producing corrected configuration.

When should an agent use it?

Trigger it when list_pages, new_page, or navigate_page fail, or when the Chrome DevTools MCP server initialization fails.

How does it fix problems?

It discovers configuration, triages common errors to likely causes, consults known issues, and formulates corrected configuration for the user's OS and environment.

How does it confirm success?

It runs diagnostics and verifies a successful connection using the list_pages tool.

Use from source

Ask your Buda agent to install this community skill.

Copy this prompt into your own Buda agent. It includes the source repository and install command so the agent can complete the setup in natural language.

Prompt to send to your Buda agent
Please install the "Chrome DevTools MCP Troubleshooting Skill" skill into this Buda agent.

Source repository: https://github.com/ChromeDevTools/chrome-devtools-mcp
Install command: npx skills add ChromeDevTools/chrome-devtools-mcp --skill troubleshooting -y -a universal

Please run the install command, verify the skill is available, and tell me any setup notes or follow-up steps from the source repository.
Explore marketplace

Install workflow

  1. 1Copy the prompt
  2. 2Send it to your Buda agent
  3. 3Done