Overview
chrome-mcp-troubleshooting is an open-source integrations skill for Claude Code and compatible agents, published by trailofbits. Its author describes it as: “Diagnose and fix Claude in Chrome MCP extension connectivity issues. Use when mcp__claude-in-chrome__* tools fail, return "Browser extension is not connected", or behave erratically.”. The project has 6.6k stars on GitHub and is available under the CC-BY-SA-4.0 license. Add it to your setup with `/plugin marketplace add trailofbits/skills`.
What chrome-mcp-troubleshooting does
Use this skill when Claude in Chrome MCP tools fail to connect or work unreliably.
What’s inside
The SKILL.md for chrome-mcp-troubleshooting is organised into these sections:
- When to Use
- When NOT to Use
- The Claude.app vs Claude Code Conflict (Primary Issue)
- Two Native Hosts, Two Socket Formats
- Why They Conflict
- The Fix: Disable Claude.app's Native Host
- Toggle Script
- Quick Diagnosis
- Critical Insight
- Full Reset Procedure (Claude Code CLI)
- Other Common Causes
- Multiple Chrome Profiles
Installation
Add chrome-mcp-troubleshooting to your agent with:
/plugin marketplace add trailofbits/skills Review a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
License
chrome-mcp-troubleshooting is published under the CC-BY-SA-4.0 license.
Strengths
- Clear CC-BY-SA-4.0 license — safe to read and adapt within its terms
- Ships in trailofbits/skills, an established project with 6,646 GitHub stars
- Works with Claude Code
- Actively maintained — repository updated in the last 90 days
Author
Topics
Alternatives to chrome-mcp-troubleshooting
Similar skills from other repositories:
Frequently asked questions
- What does chrome-mcp-troubleshooting do?
- Diagnose and fix Claude in Chrome MCP extension connectivity issues. Use when mcp__claude-in-chrome__* tools fail, return "Browser extension is not connected", or behave erratically.
- How do I install chrome-mcp-troubleshooting?
- Run /plugin marketplace add trailofbits/skills in your agent, then reload your skills. Review the source at https://github.com/trailofbits/skills before installing.
- Is chrome-mcp-troubleshooting free to use?
- Yes. chrome-mcp-troubleshooting is free and open source under the CC-BY-SA-4.0 license, so you can read, run, and adapt it within that license's terms.
- Which agents does chrome-mcp-troubleshooting work with?
- chrome-mcp-troubleshooting lists Claude Code — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does chrome-mcp-troubleshooting come from?
- chrome-mcp-troubleshooting ships inside trailofbits/skills, a repository that contains 41 catalogued skills in total. The repository's 6,646 GitHub stars apply to that whole collection, not to this skill on its own.