Agent skill

Operate Firefox Marionette

by cyberful in cyberful/cyberful

Operate a managed Firefox/Marionette laboratory for privileged chrome-context experiments, content automation, real WebDriver windows, permission readback, and synthetic X11 clipboard controls.

AGPL-3.0Auto-check passedSecurity

Install Operate Firefox Marionette

skills CLI
$ npx skills add cyberful/cyberful --skill operate-firefox-marionette -a claude-code

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

GitHub CLI
$ gh skill install cyberful/cyberful operate-firefox-marionette --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/cyberful/cyberful.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cyberful/builtin/skills/operate-firefox-marionette .claude/skills/operate-firefox-marionette && 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
operate-firefox-marionette
GitHub stars
135
Token cost
~673 tokens
SKILL.md length
239 words
Files
2
Skills in repo
85
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Operate a managed Firefox/Marionette laboratory for privileged chrome-context experiments, content automation, real WebDriver windows, permission readback, and synthetic X11 clipboard controls.

  • A browser-security discriminator depends on a specific Firefox executable
  • SKILL.md covers Establish a baseline, Exercise one discriminator and Close and classify
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Chrome/content context

What it does

Operate Firefox Marionette is an agent skill from cyberful/cyberful. Operate a managed Firefox/Marionette laboratory for privileged chrome-context experiments, content automation, real WebDriver windows, permission readback, and synthetic X11 clipboard controls. Use when a browser-security discriminator depends on a specific Firefox executable, chrome/content context, Marionette responses, permission APIs, window lifecycle, or X11 clipboard ownership.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Security. The repository describes itself as: Cyberful is an open-source AI Red Team for discovering, exploiting, verifying, and remediating vulnerabilities. The licence is AGPL-3.0.

When your agent uses it

  • A browser-security discriminator depends on a specific Firefox executable
  • Chrome/content context
  • Marionette responses
  • Permission APIs

Example prompts

  • “/operate-firefox-marionette”

What it can do on your machine

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

    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

Operate Firefox Marionette loads about 673 tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 239 words of instructions outside code blocks.

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

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

The full file from cyberful/cyberful at commit ec598a6, republished under its AGPL-3.0 licence (© cyberful). 239 words, ~673 tokens.

Download SKILL.mdSave it as .claude/skills/operate-firefox-marionette/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
operate-firefox-marionette
description
Operate a managed Firefox/Marionette laboratory for privileged chrome-context experiments, content automation, real WebDriver windows, permission readback, and synthetic X11 clipboard controls. Use when a browser-security discriminator depends on a specific Firefox executable, chrome/content context, Marionette responses, permission APIs, window lifecycle, or X11 clipboard ownership.
metadata.domain
security-tooling
metadata.subdomain
browser-laboratory
metadata.triggers
Firefox Marionette laboratory, privileged Firefox experiment, Firefox permission readback, chrome context browser test, X11 clipboard browser test
metadata.tags
Firefox, Marionette, WebDriver, browser-lab, X11

Operate Firefox Marionette

Use firefox_lab only for authorized browser-security tests requiring an exact Firefox build, Marionette/BiDi, chrome context, privileged permissions, or controlled X11. Use normal browser tools for program-platform browsing.

Establish a baseline

Record the executable/hash, target behavior, context, origin, permission, expected signal, controls, and teardown. Launch with expected_build_sha256 when known, call status, and retain its port, profile, display, capabilities, complete web_socket_url, process identity, and log. Consume the advertised BiDi URL verbatim; never derive an endpoint from its port.

For permissions, run an unseeded control first. set_permission uses Firefox's privileged API and immediate readback. A failed seed/readback is inconclusive. Never edit profile databases.

Exercise one discriminator

Use new_window, not synthetic gBrowser.addTab tabs. Create and record every race context before perturbing a content process. Use navigate and the smallest decisive execute script; request chrome only when essential. Check status before dependent work. For BiDi, create all Marionette prerequisites, call handoff_bidi, use its URL, and correlate responses by command ID. Marionette is unavailable after handoff.

For clipboard tests, set synthetic UTF-8, inspect only TARGETS/ownership, then clear it. Never read or retain real clipboard contents.

Close and classify

Always call idempotent close, including after BiDi handoff; it owns Firefox, Xvfb, profile, transports, windows, and cleanup. Use status process identity, never command-text PID matching (ps|awk, pgrep -f, pkill -f). Preserve build, controls, results, logs, failure point, and cleanup. Failed controls, transport/context loss, incomplete non-controls, or unreadable permissions are inconclusive harness results, not findings.

© cyberful, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in cyberful/builtin/skills/operate-firefox-marionette of cyberful/cyberful.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit ec598a6

Compare with similar skills

Operate Firefox Marionette 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.

Operate Firefox Marionette compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Operate Firefox Marionette this skillcyberful/cyberful135—~673Automated safety check: PassAGPL-3.0
Deepsec Documentation Guidevercel-labs/deepsec8.1k—~956Automated safety check: PassApache-2.0
Skill Scannergetsentry/skills1k4 repos~2.5kAutomated safety check: WarnApache-2.0
Serenity Aleabitoreddityan-labs/serenity-aleabitoreddit4811 repos~3.3kAutomated safety check: PassNone
Security Alert Triageelastic/agent-skills5921 repos~3.5kAutomated safety check: NotesApache-2.0
Shiro Attack CLISummerSec/ShiroAttack22.6k—~945Automated safety check: PassMIT

Similar skills

  • Deepsec Documentation Guide

    vercel-labs/deepsec

    Official

    Points the agent at deepsec's own docs to answer questions about initializing, configuring, resuming, scanning with and extending the vulnerability scanner.

    8.1k GitHub stars~956 tokensUpdated 12 days ago
    SecurityAuto-check passed
  • Skill Scanner

    getsentry/skills

    Official

    Scan agent skills for security issues. An agent skill from getsentry/skills.

    1k GitHub starsUsed in 4 repos~2.5k tokens
    SecurityAuto-check: warnings
  • Serenity Aleabitoreddit

    yan-labs/serenity-aleabitoreddit

    Apply trader Serenity's (@aleabitoreddit) AI/semiconductor supply-chain analytical lens to US-stock ideas and market judgment.

    481 GitHub starsUsed in 1 repo~3.3k tokens
    SecurityAuto-check passed
  • Security Alert Triage

    elastic/agent-skills

    Official

    Triage Elastic Security alerts — gather context, classify threats, create cases, and acknowledge.

    592 GitHub starsUsed in 1 repo~3.5k tokens
    SecurityAuto-check: notes
  • Shiro Attack CLI

    SummerSec/ShiroAttack2

    当用户要求利用、检测或测试 Apache Shiro rememberMe 反序列化漏洞 (Shiro-550, CVE-2016-4437) 时使用。触发词包括 "Shiro"、"rememberMe"、"shiro attack"、"CVE-2016-4437"、"Shiro-550"、"爆破 Shiro key"、"利用 Shiro"、"Shiro…

    2.6k GitHub stars~945 tokensUpdated 4 mo ago
    SecurityAuto-check passed
  • Cve Remediation

    rundeck/rundeck

    Verify if a CVE affects the project and remediate it. An agent skill from rundeck/rundeck.

    6.3k GitHub stars~2.9k tokensUpdated yesterday
    SecurityAuto-check passed

More from cyberful/cyberful

All 85 skills in this repo
  • Audit infrastructure-as-code artifacts for unsafe defaults, policy gaps, privilege exposure, control drift, and deployment-impact evidence.

    135 GitHub stars~649 tokensUpdated 1 mo ago
    Auto-check passed
  • Audit Kubernetes admission and policy-as-code enforcement against local workload manifests, exception paths, namespace scope, and deployment evidence.

    135 GitHub stars~610 tokensUpdated 1 mo ago
    Auto-check passed
  • Audit PCI DSS penetration-test methodology, scope, internal and external reports, segmentation results, tester independence, remediation, retesting, retention, and multi-tenant support evidence.

    135 GitHub stars~1k tokensUpdated 1 mo ago
    Auto-check passed
  • Operate Content Discovery

    cyberful/cyberful

    Design and interpret advanced content discovery with ffuf and complementary web fuzzers.

    135 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Operate Network Recon

    cyberful/cyberful

    Build a high-fidelity network and service inventory using Nmap, Masscan, packet capture, DNS, and protocol-specific follow-up.

    135 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Operate Sast Toolchain

    cyberful/cyberful

    Operate Semgrep and source-oriented static analysis as a hypothesis, coverage, and regression system during advanced code audits.

    135 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Operate Firefox Marionette

What does Operate Firefox Marionette do?

Operate a managed Firefox/Marionette laboratory for privileged chrome-context experiments, content automation, real WebDriver windows, permission readback, and synthetic X11 clipboard controls. Operate Firefox Marionette is an agent skill from cyberful/cyberful. Operate a managed Firefox/Marionette laboratory for privileged chrome-context experiments, content automation, real WebDriver windows, permission readback, and synthetic X11 clipboard controls.

When should I use Operate Firefox Marionette?

Operate Firefox Marionette fits situations like: A browser-security discriminator depends on a specific Firefox executable; chrome/content context; marionette responses; permission APIs.

How do I install Operate Firefox Marionette in Claude Code?

Run `npx skills add cyberful/cyberful --skill operate-firefox-marionette -a claude-code`. Or copy the skill folder (cyberful/builtin/skills/operate-firefox-marionette in cyberful/cyberful) into .claude/skills/operate-firefox-marionette in your project. Claude Code loads it when a task matches its description.

How do I install Operate Firefox Marionette in Codex?

Run `npx skills add cyberful/cyberful --skill operate-firefox-marionette -a codex`. Or copy the skill folder (cyberful/builtin/skills/operate-firefox-marionette in cyberful/cyberful) into .agents/skills/operate-firefox-marionette in your project. Codex loads it when a task matches its description.

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

What does Operate Firefox Marionette need to run?

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

Does Operate Firefox Marionette 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 Operate Firefox Marionette 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 Operate Firefox Marionette use?

Operate Firefox Marionette is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Operate Firefox Marionette use?

About 673 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 Operate Firefox Marionette?

Skills that share tags, products or a category with Operate Firefox Marionette: Deepsec Documentation Guide (vercel-labs/deepsec, 8.1k stars), Skill Scanner (getsentry/skills, 1k stars), Serenity Aleabitoreddit (yan-labs/serenity-aleabitoreddit, 481 stars) and Security Alert Triage (elastic/agent-skills, 592 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Operate Firefox Marionette?

cyberful (a GitHub organization) maintains it in cyberful/cyberful, which has 135 GitHub stars. The repository holds 85 skills in this directory. The repository was last updated on August 24, 2026.

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