Agent skill

File Good First Bug

by BrowserWorks in BrowserWorks/waterfox-android

A skill your agent uses when the user wants to file good-first-bugs in Bugzilla for Firefox.

Custom licenceAuto-check passedDevelopment

Install File Good First Bug

skills CLI
$ npx skills add BrowserWorks/waterfox-android --skill file-good-first-bug -a claude-code

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

GitHub CLI
$ gh skill install BrowserWorks/waterfox-android file-good-first-bug --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/BrowserWorks/waterfox-android.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/file-good-first-bug .claude/skills/file-good-first-bug && 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
file-good-first-bug
GitHub stars
379
Used in
2 other repos
Token cost
~2k tokens
SKILL.md length
950 words
Files
2 (incl. scripts)
Skills in repo
10
Repo updated
First seen
Licence
Custom licence

At a glance

A skill your agent uses when the user wants to file good-first-bugs in Bugzilla for Firefox.

  • Works in 5 steps: Understand the task source. The user… → Decide on bug shape. Prefer one bug per… → Propose to the user before filing. Use… → …
  • The user wants to file good-first-bugs in Bugzilla for Firefox
  • SKILL.md covers What is a good first bug, Workflow, Choosing product/component and Tracker bug, plus 8 more sections
  • Runs Python scripts from its folder; reaches firefox-source-docs.mozilla.org and searchfox.org

What it does

File Good First Bug is an agent skill from BrowserWorks/waterfox-android. Use this skill when the user wants to file good-first-bugs in Bugzilla for Firefox. A good-first-bug is a narrow, self-contained, low-risk task scoped so a first-time contributor can land it without deep context. Sources include lint warnings, small typos, dead-code removal, mechanical refactors, docs conversions, or any other small task the user points at. Produces prefilled enterbug.cgi URLs the user clicks to submit. Trigger on phrases like "file a good first bug", "open good first bugs for X", "create a…

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/build_url.py`).

It sits in Development, covering Linting and formatting and Refactoring. It works with Android.

When your agent uses it

  • The user wants to file good-first-bugs in Bugzilla for Firefox
  • Phrases like file a good first bug
  • Open good first bugs for X
  • Create a good-first-bug from this

Example prompts

  • “file a good first bug”
  • “open good first bugs for X”
  • “create a good-first-bug from this”
  • “/file-good-first-bug”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Understand the task source. The user will point at something: a file, a lint output, a typo, a paragraph of docs, a deprecated call site…
  2. Decide on bug shape. Prefer one bug per file / per atomic task. Combine only if the user explicitly asks. Multiple small bugs let…
  3. Propose to the user before filing. Use AskUserQuestion to confirm scope and which items to file. Never generate bug URLs without explicit…
  4. Generate prefilled enter_bug.cgi URLs. There is no MCP tool to create Bugzilla bugs - the user submits each bug by clicking its URL. Use…
  5. Print the URLs, one per item, prefixed with what the bug is about so the user can scan and click.

What it can do on your machine

Read from SKILL.md and the folder at commit 500d48c. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • firefox-source-docs.mozilla.org
    • searchfox.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

File Good First Bug loads about 2k tokens when it runs. Until then it costs about 141 tokens; SKILL.md has 950 words of instructions outside code blocks.

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

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); the scripts in this folder 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 950 words (~2,023 tokens).

“A bug a newcomer can pick up cold and finish in one short patch. The hallmarks:”

— opening of SKILL.md by BrowserWorks, Custom licence
name
file-good-first-bug

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in .agents/skills/file-good-first-bug of BrowserWorks/waterfox-android.

  • SKILL.md
  • scripts/build_url.py

Open the folder on GitHubat commit 500d48c

Used in 3 other repositories

We found 7 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in BrowserWorks/waterfox-android, which our catalogue first saw on October 7, 2026.

Compare with similar skills

File Good First Bug 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.

File Good First Bug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
File Good First Bug this skillBrowserWorks/waterfox-android3792 repos~2kAutomated safety check: PassCustom licence
Dep Validateblokadaorg/blokada3.3k—~5.7kAutomated safety check: NotesMPL-2.0
Rust Best Practicesfarm-fe/farm5.6k3 repos~1.1kAutomated safety check: PassMIT
Improve Codebase Architectureywwynm/EverythingDone14415 repos~1.3kAutomated safety check: PassGPL-3.0
Code Guidelinesgetsentry/sentry-react-native1.8k—~3.2kAutomated safety check: PassMIT
Unslop CodeJCarterJohnson/vibecoded-design-tells511—~2.5kAutomated safety check: PassCustom licence

Similar skills

  • Dep Validate

    blokadaorg/blokada

    A skill your agent uses to validate risky dependency bumps end to end as a local or cloud-launched agent.

    3.3k GitHub stars~5.7k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook.

    5.6k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Improve Codebase Architecture

    ywwynm/EverythingDone

    Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.

    144 GitHub starsUsed in 15 repos~1.3k tokens
    DevelopmentAuto-check passed
  • Code Guidelines

    getsentry/sentry-react-native

    Official

    Enforce Sentry React Native SDK code guidelines for implementation, refactoring, and review.

    1.8k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Unslop Code

    JCarterJohnson/vibecoded-design-tells

    Strips the tells that make source code read as AI-generated and forces code that fits the project instead of the model's default average.

    511 GitHub stars~2.5k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Code Quality Gate

    fengshao1227/ccg-workflow

    Scans code for complexity, long functions, duplicated blocks, naming problems and code smells with a Node script, then reports and suggests refactors.

    5.9k GitHub stars~593 tokensUpdated 23 days ago
    DevelopmentAuto-check: notes

More from BrowserWorks/waterfox-android

All 10 skills in this repo
  • Find Reviewer

    BrowserWorks/waterfox-android

    Find the right reviewer for a Firefox/Gecko change so the user does not have to.

    379 GitHub starsUsed in 1 repo~898 tokens
    Auto-check passed
  • Fluent Migration

    BrowserWorks/waterfox-android

    A skill your agent uses when a patch or local changes rename, restructure, move, or replace Fluent (.ftl) strings - or migrate legacy .properties strings to Fluent - and you need a migration recipe…

    379 GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • Media Patch Review

    BrowserWorks/waterfox-android

    Reviews dom/media code changes ONLY — not any other component.

    379 GitHub starsUsed in 1 repo~762 tokens
    Auto-check passed
  • Perftest

    BrowserWorks/waterfox-android

    Run Firefox performance tests locally or in CI. An agent skill from BrowserWorks/waterfox-android.

    379 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Spec Trace

    BrowserWorks/waterfox-android

    Trace a claim about web spec behaviour through the algorithm call chain and produce a Bugzilla-ready markdown trace ending in a REACHED / NOT REACHED / INCONCLUSIVE verdict.

    379 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Documentation

    BrowserWorks/waterfox-android

    A skill your agent uses when working with Firefox documentation, including building documentation with ./mach doc, fixing Sphinx build errors or warnings, modifying existing documentation, or adding…

    379 GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed

Works with

Categories

Questions about File Good First Bug

What does File Good First Bug do?

A skill your agent uses when the user wants to file good-first-bugs in Bugzilla for Firefox. File Good First Bug is an agent skill from BrowserWorks/waterfox-android. Use this skill when the user wants to file good-first-bugs in Bugzilla for Firefox.

When should I use File Good First Bug?

File Good First Bug fits situations like: the user wants to file good-first-bugs in Bugzilla for Firefox; phrases like file a good first bug; open good first bugs for X; create a good-first-bug from this.

How do I install File Good First Bug in Claude Code?

Run `npx skills add BrowserWorks/waterfox-android --skill file-good-first-bug -a claude-code`. Or copy the skill folder (.agents/skills/file-good-first-bug in BrowserWorks/waterfox-android) into .claude/skills/file-good-first-bug in your project. Claude Code loads it when a task matches its description.

How do I install File Good First Bug in Codex?

Run `npx skills add BrowserWorks/waterfox-android --skill file-good-first-bug -a codex`. Or copy the skill folder (.agents/skills/file-good-first-bug in BrowserWorks/waterfox-android) into .agents/skills/file-good-first-bug in your project. Codex loads it when a task matches its description.

Can I use File Good First Bug 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 BrowserWorks/waterfox-android --skill file-good-first-bug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/file-good-first-bug, .gemini/skills/file-good-first-bug, .github/skills/file-good-first-bug and .opencode/skills/file-good-first-bug in your project.

What does File Good First Bug need to run?

Going by SKILL.md and its folder, File Good First Bug needs Python for the scripts in its folder. Our summary lists: Python 3.

Does File Good First Bug access the network?

SKILL.md names 2 domains. In commands or code: firefox-source-docs.mozilla.org and searchfox.org; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is File Good First Bug 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does File Good First Bug use?

File Good First Bug 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 File Good First Bug use?

About 2k tokens (SKILL.md is roughly 8.1k 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 File Good First Bug?

Skills that share tags, products or a category with File Good First Bug: Dep Validate (blokadaorg/blokada, 3.3k stars), Rust Best Practices (farm-fe/farm, 5.6k stars), Improve Codebase Architecture (ywwynm/EverythingDone, 144 stars) and Code Guidelines (getsentry/sentry-react-native, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains File Good First Bug?

BrowserWorks (a GitHub organization) maintains it in BrowserWorks/waterfox-android, which has 379 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 22, 2026.

Source: BrowserWorks/waterfox-android on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.