Agent skill

Firefox Devtools Diagnose

by mozilla in mozilla/firefox-devtools-mcp

Diagnose Firefox DevTools MCP setup issues. An agent skill from mozilla/firefox-devtools-mcp.

Custom licenceAuto-check passed

Install Firefox Devtools Diagnose

skills CLI
$ npx skills add mozilla/firefox-devtools-mcp --skill firefox-devtools-diagnose -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mozilla/firefox-devtools-mcp firefox-devtools-diagnose --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mozilla/firefox-devtools-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/firefox-devtools-troubleshoot/skills/diagnose .claude/skills/firefox-devtools-diagnose && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
firefox-devtools-diagnose
GitHub stars
468
Token cost
~672 tokens
SKILL.md length
358 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
Custom licence

At a glance

Diagnose Firefox DevTools MCP setup issues. An agent skill from mozilla/firefox-devtools-mcp.

  • Works in 4 steps: Check Node.js → Check Your Own Tool List → Check Installation and Tab Together → …
  • Calls node

What it does

Firefox Devtools Diagnose is an agent skill from mozilla/firefox-devtools-mcp. Diagnose Firefox DevTools MCP setup issues. Activate when the firefox-devtools-mcp plugin fails to connect, its tools are not available, or the user reports Firefox DevTools not working in Cowork.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Chrome DevTools, Node.js and Model Context Protocol. The repository describes itself as: Model Context Protocol server for Firefox DevTools - enables AI assistants to inspect and control Firefox browser through WebDriver BiDi.

Example prompts

  • “/firefox-devtools-diagnose”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Check Node.js
  2. Check Your Own Tool List
  3. Check Installation and Tab Together
  4. Escalate

What it can do on your machine

Read from SKILL.md and the folder at commit 5c69888. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • nodejs.org
    • github.com
    • bugzilla.mozilla.org
    • chat.mozilla.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Firefox Devtools Diagnose loads about 672 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 358 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~672

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 358 words (~672 tokens).

“When Firefox DevTools MCP tools are unavailable or the user reports issues with the firefox-devtools-mcp plugin, run this diagnostic sequence automatically. Do not ask the user to do these checks manually.”

— opening of SKILL.md by mozilla, Custom licence
name
firefox-devtools-diagnose

Read the full SKILL.md on GitHub

Files

Just SKILL.md in plugins/firefox-devtools-troubleshoot/skills/diagnose of mozilla/firefox-devtools-mcp.

Open the folder on GitHubat commit 5c69888

Compare with similar skills

Firefox Devtools Diagnose next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Firefox Devtools Diagnose compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Firefox Devtools Diagnose this skillmozilla/firefox-devtools-mcp468—~672Automated safety check: PassCustom licence
Browser Setupclacky-ai/openclacky1.2k—~3.1kAutomated safety check: NotesMIT
Nix Chrome Devtools MCPsrid/emanote963—~271Automated safety check: PassCustom licence
Chrome CDP Browser Controlzenstory-ai/oh-story-claudecode7.3k2 repos~1.2kAutomated safety check: PassMIT
Browser Testing with Chrome DevToolsaddyosmani/agent-skills102k4 repos~3.5kAutomated safety check: WarnMIT
agentmemory Setup and Diagnosticsrohitg00/agentmemory29k—~1kAutomated safety check: NotesApache-2.0

Similar skills

  • Browser Setup

    clacky-ai/openclacky

    Configure the browser tool for Clacky. An agent skill from clacky-ai/openclacky.

    1.2k GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check: notes
  • chrome-devtools-mcp launcher — a single bash script that resolves Playwright's bundled Chrome-for-Testing and Node.js directly through Nix.

    963 GitHub stars~271 tokensUpdated 2 mo ago
    Testing & QAAuto-check passed
  • Chrome CDP Browser Control

    zenstory-ai/oh-story-claudecode

    Drives a Chrome window over the DevTools Protocol with the agent-browser CLI, so the agent can reuse your logged-in sessions, read pages and pull tokens.

    7.3k GitHub starsUsed in 2 repos~1.2k tokens
    Productivity & AutomationAuto-check passed
  • Connects an agent to a real Chrome instance through the Chrome DevTools MCP server, so it can inspect the DOM, read console errors and profile performance directly.

    102k GitHub starsUsed in 4 repos~3.5k tokens
    Testing & QAAuto-check: warnings
  • Sets up and troubleshoots a local agentmemory install, covering the MCP connection, environment variables, ports, authentication and optional feature flags.

    29k GitHub stars~1k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from mozilla/firefox-devtools-mcp

  • Web Performance

    mozilla/firefox-devtools-mcp

    Find and fix why a website is slow by capturing and analyzing a Firefox performance profile, or by analyzing a profile the user already has (a saved file or a profiler.firefox.com share link).

    468 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Browser Automation

    mozilla/firefox-devtools-mcp

    This skill should be used when the user asks about browser automation, testing web pages, extracting content, filling forms, taking screenshots, or monitoring console/network activity.

    468 GitHub stars~807 tokensUpdated yesterday
    Auto-check passed
  • Debug

    mozilla/firefox-devtools-mcp

    Show console errors and failed network requests. An agent skill from mozilla/firefox-devtools-mcp.

    468 GitHub stars~241 tokensUpdated yesterday
    Auto-check passed
  • Navigate

    mozilla/firefox-devtools-mcp

    Navigate Firefox to a URL and take a DOM snapshot for interaction

    468 GitHub stars~192 tokensUpdated yesterday
    Auto-check passed
  • Screenshot

    mozilla/firefox-devtools-mcp

    Take a screenshot of a URL or the current page. An agent skill from mozilla/firefox-devtools-mcp.

    468 GitHub stars~318 tokensUpdated yesterday
    Auto-check passed

Questions about Firefox Devtools Diagnose

What does Firefox Devtools Diagnose do?

Diagnose Firefox DevTools MCP setup issues. An agent skill from mozilla/firefox-devtools-mcp. Firefox Devtools Diagnose is an agent skill from mozilla/firefox-devtools-mcp. Diagnose Firefox DevTools MCP setup issues.

How do I install Firefox Devtools Diagnose in Claude Code?

Run `npx skills add mozilla/firefox-devtools-mcp --skill firefox-devtools-diagnose -a claude-code`. Or copy the skill folder (plugins/firefox-devtools-troubleshoot/skills/diagnose in mozilla/firefox-devtools-mcp) into .claude/skills/firefox-devtools-diagnose in your project. Claude Code loads it when a task matches its description.

How do I install Firefox Devtools Diagnose in Codex?

Run `npx skills add mozilla/firefox-devtools-mcp --skill firefox-devtools-diagnose -a codex`. Or copy the skill folder (plugins/firefox-devtools-troubleshoot/skills/diagnose in mozilla/firefox-devtools-mcp) into .agents/skills/firefox-devtools-diagnose in your project. Codex loads it when a task matches its description.

Can I use Firefox Devtools Diagnose in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mozilla/firefox-devtools-mcp --skill firefox-devtools-diagnose -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/firefox-devtools-diagnose, .gemini/skills/firefox-devtools-diagnose, .github/skills/firefox-devtools-diagnose and .opencode/skills/firefox-devtools-diagnose in your project.

What does Firefox Devtools Diagnose need to run?

Going by SKILL.md and its folder, Firefox Devtools Diagnose needs the command-line tools its instructions call (node). Our summary lists: Node.js.

Does Firefox Devtools Diagnose access the network?

SKILL.md names 4 domains. As links in the text: nodejs.org, github.com, bugzilla.mozilla.org and chat.mozilla.org. This is read from the text; nothing was executed.

Is Firefox Devtools Diagnose safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Firefox Devtools Diagnose use?

Firefox Devtools Diagnose has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Firefox Devtools Diagnose use?

About 672 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Firefox Devtools Diagnose?

Skills that share tags, products or a category with Firefox Devtools Diagnose: Browser Setup (clacky-ai/openclacky, 1.2k stars), Nix Chrome Devtools MCP (srid/emanote, 963 stars), Chrome CDP Browser Control (zenstory-ai/oh-story-claudecode, 7.3k stars) and Browser Testing with Chrome DevTools (addyosmani/agent-skills, 102k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Firefox Devtools Diagnose?

mozilla (a GitHub organization) maintains it in mozilla/firefox-devtools-mcp, which has 468 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 6, 2026.

Source: mozilla/firefox-devtools-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.