Agent skill

Documentation

by BrowserWorks in 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…

Custom licenceAuto-check passedDevelopment

Install Documentation

skills CLI
$ npx skills add BrowserWorks/waterfox-android --skill documentation -a claude-code

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

GitHub CLI
$ gh skill install BrowserWorks/waterfox-android documentation --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/documentation .claude/skills/documentation && 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
documentation
GitHub stars
376
Used in
1 other repo
Token cost
~1.6k tokens
SKILL.md length
757 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
Custom licence

At a glance

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…

  • Works in 2 steps: Reproduce the issue locally → Identify the type of Sphinx problem
  • Working with Firefox documentation
  • SKILL.md covers Overview, Core Principles, Recommended Workflow and Documentation Layout, plus 4 more sections
  • Reaches firefox-source-docs.mozilla.org

What it does

Documentation is an agent skill from BrowserWorks/waterfox-android. Use this skill when working with Firefox documentation, including building documentation with ./mach doc, fixing Sphinx build errors or warnings, modifying existing documentation, or adding new docs.

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

It sits in Development. It works with Android.

When your agent uses it

  • Working with Firefox documentation
  • Including building documentation with ./mach doc
  • Fixing Sphinx build errors
  • Modifying existing documentation

Example prompts

  • “/documentation”

Workflow steps

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

  1. Reproduce the issue locally
  2. Identify the type of Sphinx problem

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

    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

Documentation loads about 1.6k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 757 words of instructions outside code blocks.

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

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 757 words (~1,613 tokens).

“Firefox documentation is built using Sphinx through the ./mach doc command. Documentation sources are distributed throughout the repository and are written in Markdown (.md).”

— opening of SKILL.md by BrowserWorks, Custom licence
name
documentation

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/documentation of BrowserWorks/waterfox-android.

Open the folder on GitHubat commit 500d48c

Used in 1 other repository

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

Compare with similar skills

Documentation 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.

Documentation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Documentation this skillBrowserWorks/waterfox-android3761 repos~1.6kAutomated safety check: PassCustom licence
Android UI Visual Reviewpermissionlesstech/bitchat-android7.7k—~2.6kAutomated safety check: PassGPL-3.0
Improve Codebase Architectureywwynm/EverythingDone14415 repos~1.3kAutomated safety check: PassGPL-3.0
Commit PRsamuelclay/NewsBlur7.6k—~4.1kAutomated safety check: PassMIT
Find My Flagsandroidx/androidx6.1k—~664Automated safety check: PassApache-2.0
jscpd Code Migration Trackerkucherenko/jscpd6.3k—~5kAutomated safety check: PassMIT

Similar skills

  • Android UI Visual Review

    permissionlesstech/bitchat-android

    Analyze an Android pull request, branch, commit, or patch for user-visible changes and produce reproducible before/after screenshots from isolated builds.

    7.7k GitHub stars~2.6k tokensUpdated yesterday
    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
  • Commit PR

    samuelclay/NewsBlur

    A skill your agent uses when the user runs /commit-pr, says "commit and push", "open a PR", "ship this", asks to update an existing PR with new changes, or asks to resolve PR review comments in the…

    7.6k GitHub stars~4.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Find My Flags

    androidx/androidx

    A skill your agent uses to find Compose feature flags introduced by a specific git user or email and map them to the library version in which they were added.

    6.1k GitHub stars~664 tokensUpdated today
    DevelopmentAuto-check passed
  • Measures a code port between languages or frameworks with jscpd's function-level comparison, porting tests before code and tracking what is left unmatched.

    6.3k GitHub stars~5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Compares two folders function by function with jscpd --compare, across languages if needed, and explains which functions match and which have no counterpart.

    6.3k GitHub stars~3.2k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from BrowserWorks/waterfox-android

All 10 skills in this repo
  • File Good First Bug

    BrowserWorks/waterfox-android

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

    376 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Reviewer

    BrowserWorks/waterfox-android

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

    376 GitHub stars~898 tokensUpdated 15 days ago
    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…

    376 GitHub stars~4.2k tokensUpdated 15 days ago
    Auto-check passed
  • Media Patch Review

    BrowserWorks/waterfox-android

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

    376 GitHub stars~762 tokensUpdated 15 days ago
    Auto-check passed
  • Perftest

    BrowserWorks/waterfox-android

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

    376 GitHub stars~2.3k tokensUpdated 15 days ago
    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.

    376 GitHub stars~2k tokensUpdated 15 days ago
    Auto-check passed

Works with

Categories

Questions about Documentation

What does Documentation do?

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…. Documentation is an agent skill from BrowserWorks/waterfox-android./mach doc, fixing Sphinx build errors or warnings, modifying existing documentation, or adding new docs.

When should I use Documentation?

Documentation fits situations like: working with Firefox documentation; including building documentation with ./mach doc; fixing Sphinx build errors; modifying existing documentation.

How do I install Documentation in Claude Code?

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

How do I install Documentation in Codex?

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

Can I use Documentation 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 documentation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/documentation, .gemini/skills/documentation, .github/skills/documentation and .opencode/skills/documentation in your project.

What does Documentation need to run?

SKILL.md names no scripts, command-line tools or credentials: Documentation is instructions for the agent only.

Does Documentation access the network?

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

Is Documentation 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 Documentation use?

Documentation 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 Documentation use?

About 1.6k tokens (SKILL.md is roughly 6.5k 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 Documentation?

Skills that share tags, products or a category with Documentation: Android UI Visual Review (permissionlesstech/bitchat-android, 7.7k stars), Improve Codebase Architecture (ywwynm/EverythingDone, 144 stars), Commit PR (samuelclay/NewsBlur, 7.6k stars) and Find My Flags (androidx/androidx, 6.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Documentation?

BrowserWorks (a GitHub organization) maintains it in BrowserWorks/waterfox-android, which has 376 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.