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

Custom licenceAuto-check passedDevelopment

Install Perftest

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

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

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

At a glance

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

  • The user asks how to run a perf test
  • SKILL.md covers Local or CI? Check the…, Pick the harness, Run locally and Find a test's name, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Wants to reproduce a performance alert

What it does

Perftest is an agent skill from BrowserWorks/waterfox-android. Run Firefox performance tests locally or in CI. Use when the user asks how to run a perf test, wants to reproduce a performance alert or regression locally, needs the mach invocation for Raptor, Talos, MozPerftest, AWSY, or browsertime, wants to push perf tests to try, or mentions mach try perf, mach perftest, mach raptor, mach talos-test, an alert summary ID, PerfCompare, or Compare View. Covers picking the right harness, finding a test's name, and the local-vs-CI tradeoff. Not for analyzing an existing Firefox…

Its SKILL.md is about 2.3k 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, covering Performance optimization. It works with Android and Linux.

When your agent uses it

  • The user asks how to run a perf test
  • Wants to reproduce a performance alert
  • Regression locally
  • Needs the mach invocation for Raptor

Example prompts

  • “/perftest”

Requirements

  • Pre-approved tools (allowed-tools): Bash(./mach perftest --help:*), Bash(./mach raptor --help:*), Bash(./mach raptor --print-tests:*), Bash(./mach talos-test --help:*), Bash(./mach talos-test --print-tests:*), Bash(./mach talos-test --print-suites:*), Bash(./mach awsy-test --help:*), Bash(./mach try perf --help:*), Bash(./mach try perf --no-push:*), Read, Grep, Glob

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 these tools, so the agent can use them without asking each time:

    • Bash(./mach perftest --help:*)
    • Bash(./mach raptor --help:*)
    • Bash(./mach raptor --print-tests:*)
    • Bash(./mach talos-test --help:*)
    • Bash(./mach talos-test --print-tests:*)
    • Bash(./mach talos-test --print-suites:*)
    • Bash(./mach awsy-test --help:*)
    • Bash(./mach try perf --help:*)
    • Bash(./mach try perf --no-push:*)
    • Read

    …and 2 more on the same allowed-tools line.

    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

    No URLs in SKILL.md.

    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

Perftest loads about 2.3k tokens when it runs. Until then it costs about 160 tokens; SKILL.md has 934 words of instructions outside code blocks.

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

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 934 words (~2,274 tokens).

“Any of these tests can be run locally. Whether a local run will answer the question is a separate matter — check that first.”

— opening of SKILL.md by BrowserWorks, Custom licence
name
perftest
allowed-tools
Bash(./mach perftest --help:*), Bash(./mach raptor --help:*), Bash(./mach raptor --print-tests:*), Bash(./mach talos-test --help:*), Bash(./mach talos-test --print-tests:*), Bash(./mach talos-test --print-suites:*), Bash(./mach awsy-test --help:*), Bash(./mach try perf --help:*), Bash(./mach try perf --no-push:*), Read, Grep, Glob

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/perftest 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

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

Perftest compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Perftest this skillBrowserWorks/waterfox-android3791 repos~2.3kAutomated safety check: PassCustom licence
PlotJuggler 4 Perf ProfilingPlotJuggler/PlotJuggler6.2k—~1.6kAutomated safety check: NotesMPL-2.0
The Art of Debuggingstas00/the-art-of-debugging1.7k—~6.1kAutomated safety check: NotesCC-BY-SA-4.0
Linux perf Profiling Guideintel/intel-performance-skills332—~3.1kAutomated safety check: NotesCustom licence
Dotnet Debuggingnovotnyllc/dotnet-artisan233—~2.1kAutomated safety check: PassMIT
Commitmanhpham90vn/Deskhub133—~978Automated safety check: PassMIT

Similar skills

  • PlotJuggler 4 Perf Profiling

    PlotJuggler/PlotJuggler

    Guides CPU profiling of PlotJuggler 4 on Linux with perf: count first, record cheaply with LBR, then read per-thread, flat, flamegraph or time-window views.

    6.2k GitHub stars~1.6k tokensUpdated 7 days ago
    DevelopmentAuto-check: notes
  • The Art of Debugging

    stas00/the-art-of-debugging

    Condensed debugging method and tool recipes for Unix, Python and PyTorch programs: crashes, hangs, segfaults, wrong output, CUDA OOM, NaN values and slowness.

    1.7k GitHub stars~6.1k tokensUpdated 2 days ago
    DevelopmentAuto-check: notes
  • Linux perf Profiling Guide

    intel/intel-performance-skills

    Official

    Guides perf-based profiling of Linux programs through five flows: quick hardware counters, hotspot profiling, cache contention, core-scaling, and a report.

    332 GitHub stars~3.1k tokensUpdated 10 days ago
    DevelopmentAuto-check: notes
  • Dotnet Debugging

    novotnyllc/dotnet-artisan

    Debugs Windows and Linux/macOS applications (native, .NET/CLR, mixed-mode) with WinDbg MCP (crash dumps, !analyze, !syncblk, !dlk, !runaway, !dumpheap, !gcroot, BSOD), dotnet-dump, lldb with SOS…

    233 GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Commit

    manhpham90vn/Deskhub

    Write a Deskhub commit message. An agent skill from manhpham90vn/Deskhub.

    133 GitHub stars~978 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Senior Code Critic

    nekomangaorg/Neko

    Performs rigorous, adversarial senior-staff code reviews that ruthlessly uncover architectural anti-patterns, edge cases, lifecycle hazards, memory leaks, type-safety gaps, and performance pitfalls.

    2.8k GitHub stars~1.8k 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.

    379 GitHub starsUsed in 2 repos~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.

    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
  • 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 Perftest

What does Perftest do?

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

When should I use Perftest?

Perftest fits situations like: the user asks how to run a perf test; wants to reproduce a performance alert; regression locally; needs the mach invocation for Raptor.

How do I install Perftest in Claude Code?

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

How do I install Perftest in Codex?

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

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

What does Perftest need to run?

SKILL.md names no scripts, command-line tools or credentials: Perftest is instructions for the agent only. Its frontmatter pre-approves these tools: Bash(./mach perftest --help:*), Bash(./mach raptor --help:*), Bash(./mach raptor --print-tests:*), Bash(./mach talos-test --help:*), Bash(./mach talos-test --print-tests:*), Bash(./mach talos-test --print-suites:*), Bash(./mach awsy-test --help:*), Bash(./mach try perf --help:*), Bash(./mach try perf --no-push:*), Read, Grep, Glob.

Does Perftest access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

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

About 2.3k tokens (SKILL.md is roughly 9.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 Perftest?

Skills that share tags, products or a category with Perftest: PlotJuggler 4 Perf Profiling (PlotJuggler/PlotJuggler, 6.2k stars), The Art of Debugging (stas00/the-art-of-debugging, 1.7k stars), Linux perf Profiling Guide (intel/intel-performance-skills, 332 stars) and Dotnet Debugging (novotnyllc/dotnet-artisan, 233 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Perftest?

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.