claude-in-chrome-troubleshooting-trailofbits-skills

1. 基本信息

项目	内容
名称	claude-in-chrome-troubleshooting-trailofbits-skills
作者/维护者	Trail of Bits（增强维护）；原作者 @jeffzwang（@ExaAILabs）
来源链接	https://github.com/trailofbits/skills/tree/main/plugins/claude-in-chrome-troubleshooting/skills/chrome-mcp-troubleshooting
许可证	CC-BY-SA-4.0（GitHub API 核实，仓库根 LICENSE 明确）
GitHub Stars	仓库整体 7,080（GitHub API）——本技能所属合集仓库，星数不代表该子技能个体热度
Forks	仓库整体 605（GitHub API）
最新版本	无独立版本号；仓库最近提交 2026-09-14（GitHub API）
安装方式	`/plugin install trailofbits/skills/plugins/claude-in-chrome-troubleshooting`

2. 功能介绍与亮点

claude-in-chrome-troubleshooting 专门诊断并修复 Claude in Chrome 浏览器扩展与 MCP 连接失败的问题——当 mcp__claude-in-chrome__* 工具报错「Browser extension is not connected」、浏览器自动化行为异常或超时时使用。核心能力：

命中根因：Claude.app（Cowork）与 Claude Code CLI 各自注册了互相冲突的 native messaging host（不同的二进制路径、不同的 socket 格式），导致 Chrome 扩展连到错误的宿主进程，表现为“看起来都在跑但就是连不上”。
一键切换脚本：提供 chrome-mcp-toggle 函数，在 Claude.app 与 Claude Code CLI 两种使用模式之间安全切换 native messaging 配置。
分层诊断命令：从“哪个 native host 进程在跑”“socket 在哪”“谁连上了 socket”到“哪个配置文件生效”逐层排查，附带一套完整重置流程（清理旧 socket、更新 wrapper 脚本、重启 Chrome 与 Claude Code）。
边缘情况覆盖：多 Chrome Profile 冲突、多个 Claude Code 会话并发、wrapper 脚本里硬编码了过期版本号、TMPDIR 环境变量未设置等常见诱因均单独成节。

主要亮点：由社区开发者 jeffzwang（ExaAILabs）首创，被 Trail of Bits 收录进官方 skills 市场并持续增强维护；全程零外部依赖、零联网、零付费成本。

3. 适用场景

所属分类：元技能与 Agent 增强——本技能诊断修复的是 Claude Code / Claude.app 自身的 Agent 工具链（浏览器自动化 MCP 连接），而非某个通用软件工程或第三方服务连接问题，核心价值是让 agent 的工具能力本身恢复可用。

适用于日常使用 Claude Code 或 Claude.app 进行浏览器自动化（网页测试、抓取、UI 验证等）的用户：一旦遇到扩展连接失败、行为诡异或切换 Claude.app/Claude Code 后浏览器工具失灵，可直接调用本技能自助定位并修复，无需等待官方支持工单或反复重装。

4. 跨 Agent 兼容性

Agent	结论	依据
Claude Code	✅ 原生支持	官方 `/plugin install` 命令与专属诊断路径（`~/.claude/`、`~/.local/share/claude/`）均针对 Claude Code CLI 设计
Codex	❌ 不支持	仓库 README 声明 Codex 可通过兼容层加载该 marketplace，但本技能正文诊断的是 Claude 专有的 native messaging host 冲突（Claude.app / Claude Code 二进制与 socket），Codex 无对应机制，功能不适用
OpenClaw	❓ 未验证	未找到该技能与 OpenClaw 生态的适配信息，且技能设计目标明确指向 Claude 产品线
Hermes Agent	❓ 未验证	同上

5. 推荐理由

修复Claude浏览器扩展MCP连接冲突,诊断步骤清晰零成本

6. 评分

维度	分数	说明
受欢迎程度	7	Trail of Bits 是公认的一线安全审计机构，长期出品并维护 Claude Code 专业技能集；所属合集仓库整体 7,080 stars 属整个仓库，不代表本技能个体热度；未查到该子技能自身的独立第三方评价
可用性	9	一条命令安装（`/plugin install`）；文档完整、步骤清晰、含逐层诊断命令与完整重置流程；纯 Bash + macOS 系统工具，无外部依赖无付费成本；所属仓库 2026-09-14 仍在活跃维护
安全性	8	检查清单：①涉及 shell 命令（`mv`/`ps`/`lsof`/`pkill`/`rm -rf`/`osascript`），但均限定在 Claude/Chrome 自身配置文件与已知固定路径内，范围明确、可审计 ②无外联，纯本机诊断 ③不要求任何 API key/凭据 ④SKILL.md 全文未发现可疑指令或夹带私货 ⑤原作者公开署名 + Trail of Bits 官方增强，信誉良好 ⑥License 明确（CC-BY-SA-4.0）⑦仓库近日仍在维护

综合评分：8.0（三项均值）

7. 跟同类 Skills 相比的优势

技能	定位	与本技能的差异
redis-connections（redis-agent-skills）	Redis 数据库连接故障排查	面向第三方数据库服务的连接问题，非 Claude 自身工具链
mongodb-connection（mongodb-agent-skills）	MongoDB 连接故障排查	同上，诊断对象是外部数据库而非 Agent 自身的浏览器工具
agent-platform-troubleshooting（google-skills）	Google Agent 平台故障排查	面向 Google 自家 Agent 平台的运维问题，生态与诊断对象均不同
durapensa/claude-chrome-mcp（独立第三方项目）	另一套 Claude-Chrome 交互开发者工具套件	定位是替代性实现（自建 MCP server），而非诊断修复官方扩展的连接故障，用途不同

目前罕见有专门诊断 Claude 自身 Agent 工具链（浏览器 MCP 扩展）连接故障的技能，本技能填补的是“Agent 自身基础设施排障”这一细分空白，与上述面向外部服务连接的排障技能定位不同。

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。但其诊断的连接失败问题在 anthropics/claude-code 官方仓库有多个独立 issue 记录（如 #21279、#21331、#22500、#26217，时间跨度数月），显示这是社区反复遇到的真实痛点，而非小概率边缘故障。

9. 其他补充

技能正文明确署名原始作者与增强维护方（jeffzwang / ExaAILabs → Trail of Bits），体现了社区技能被专业机构收编增强、纳入官方分发渠道的典型路径。

10. 安装使用方式

在 Claude Code 中执行 /plugin marketplace add trailofbits/skills 添加市场（若尚未添加）
执行 /plugin install trailofbits/skills/plugins/claude-in-chrome-troubleshooting 安装
该插件仅含一个技能 chrome-mcp-troubleshooting，遇到浏览器扩展连接失败等症状时会自动触发，也可用 /claude-in-chrome-troubleshooting:chrome-mcp-troubleshooting 手动调用
修复完成后需重启 Chrome 并重启 Claude Code（MCP 仅在启动时建立连接，不重启不会生效）

11. 注意事项

仅覆盖 macOS：技能正文明确声明不适用于 Linux/Windows（诊断路径基于 ~/Library/Application Support/、osascript 等 macOS 专属机制）
只解决 Claude.app 与 Claude Code CLI 之间的 native host 冲突，与网络连通性、Chrome 扩展安装失败等其他原因导致的连接问题无关，需先排除这些可能性
修复涉及移动/删除本地配置与 socket 文件，虽均限定在已知固定路径内且可通过 .disabled 后缀撤销，仍建议先确认当前使用的是 Claude.app 还是 Claude Code CLI 再执行切换，避免误切换影响另一模式的正常使用