fizz
Generate Echidna/Medusa-compatible Solidity fuzz suites from Foundry or Hardhat projects. Trigger on "fizz", "generate fuzz suite", "build fuzz harness", "stateful fuzzing", "fuzzing harness", "property testing", and "invariant suite".
Install / Use
npx skills add pashov/skills --skill fizzInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of fizz
fizz scores 84/100 on our quality scale, 2081st of 2,790 Automation skills we index.
Its SKILL.md is 43 KB long, well organised into 39 sections with 9 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
With 1,194 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so fizz is actively maintained.
- Our last check on 2026-11-06 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
fizz compared with similar skills
All 4 of these similar skills score higher than fizz; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| fizz (this skill)by pashov | 84 | 1.2k | 54d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install fizz?
- Run
npx skills add pashov/skills --skill fizz. The install tabs above show the steps for each supported agent. - Which AI agents does fizz work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is fizz safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is fizz still maintained?
- The repository was last updated about 2 months ago, so fizz is actively maintained.
Skill content
View source on GitHubname: fizz description: Generate Echidna/Medusa-compatible Solidity fuzz suites from Foundry or Hardhat projects. Trigger on "fizz", "generate fuzz suite", "build fuzz harness", "stateful fuzzing", "fuzzing harness", "property testing", and "invariant suite".
Fizz
Generate a stateful Solidity fuzz suite under {SUITE_DIR} (default: test/fizz/), with metadata and fuzzer runtime files under {META_DIR} (default: fizz_data/).
Use Echidna and Medusa for invariant campaigns. Use Foundry for compilation, smoke testing, and quick debugging.
Workflow Rules
- Follow the steps in order. Do not skip forward if a required artifact for the current step does not exist yet.
- If a step fails, stop there and report the blocker.
- If tooling is missing, say exactly what was attempted and what is missing.
- Keep the generated Solidity suite isolated under
test/fizz/and the metadata/runtime files underfizz_data/unless the user explicitly asks for different paths. - Reuse existing project setup and test logic whenever possible; do not invent a deployment flow if the repo already has one.
Parameters
PROJECT_ROOT: user-provided path, otherwise the current working directory.SKILL_PATH: the directory containing thisSKILL.md.SUITE_DIR:test/fizzrelative toPROJECT_ROOT. Pass--suite-dirto suite-generation steps.META_DIR:fizz_datarelative toPROJECT_ROOT. Pass--meta-dirto metadata steps.- Optional contract arguments narrow handler generation to specific contracts.
--no-invariantsskips Step 9 only.--max(or--opus, or "max quality") upgrades every subagent in this run from Sonnet to Opus. See "Subagent Model" below.--guided/--automaticselects the run mode. See "Run Mode" below.
Run Mode
The skill runs in one of two modes, resolved once at the start of the run and reused for every checkpoint below:
{MODE} = "guided"— the parent agent pauses for user input at key checkpoints: Step 3 (additional docs), Step 4 (interactive function picker UI), Step 4.5 (cost confirmation), Step 6 (setup review), Step 8 (per-cycle coverage decision), Step 9c (property review), Step 10 (fuzzer choice).{MODE} = "automatic"— the parent agent never pauses. Step 4 runs with--auto, Step 8 loops up to 3 coverage cycles then proceeds, Step 10 defaults to Medusa, and the cost estimate from Step 4.5 is printed but not gated on user confirmation.
Resolving {MODE}
- If the user invoked with
--guided/ "guided mode" / "walk me through" / "let me review" →{MODE} = "guided". - If the user invoked with
--automatic/--auto/ "unguided" / "run the whole thing" / "no prompts" →{MODE} = "automatic". - Otherwise, leave
{MODE}unresolved; Step 0 asks for it via the selection prompt after printing the banner.
Every subsequent instruction referencing {MODE} must substitute the resolved value. Do NOT switch modes mid-run.
Subagent Model
All subagents spawned by this skill (Step 3 fallback Protocol Analyzer, the 5 Step 9b discovery agents, the Step 9c Synthesizer, the 2 Step 9d Implementers, and the Step 11 Report Writer) default to Sonnet for cost and latency.
The parent agent orchestrating the pipeline is whatever model the user's Claude Code session is running (this skill does not control it). Only the delegated subagents are covered by {AGENT_MODEL}.
Resolving {AGENT_MODEL}
Resolve once at the start of the run and reuse it for every spawn below:
- If the user invoked with
--max/--opus/ "max quality" / "run on opus" / similar →{AGENT_MODEL} = "opus". - If the user invoked with
--sonnet/ "use sonnet" / "default model" →{AGENT_MODEL} = "sonnet". - Otherwise, leave
{AGENT_MODEL}unresolved; Step 0 asks for it via the selection prompt after printing the banner.
Every subsequent spawn instruction below references {AGENT_MODEL} — substitute the resolved value when making the actual tool call. Do NOT mix tiers within a single run.
Step 0: Print Banner
At the start of every skill run, first print this ASCII banner once before any other output — including any selection prompt:
██████╗ █████╗ ███████╗██╗ ██╗ ██████╗ ██╗ ██╗ ███████╗██╗ ██╗██╗██╗ ██╗ ███████╗
██╔══██╗██╔══██╗██╔════╝██║ ██║██╔═══██╗██║ ██║ ██╔════╝██║ ██╔╝██║██║ ██║ ██╔════╝
██████╔╝███████║███████╗███████║██║ ██║██║ ██║ ███████╗█████╔╝ ██║██║ ██║ ███████╗
██╔═══╝ ██╔══██║╚════██║██╔══██║██║ ██║╚██╗ ██╔╝ ╚════██║██╔═██╗ ██║██║ ██║ ╚════██║
██║ ██║ ██║███████║██║ ██║╚██████╔╝ ╚████╔╝ ███████║██║ ██╗██║███████╗███████╗███████║
╚═╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═══╝ ╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚══════╝
After the banner, resolve {MODE} per the "Run Mode" section and {AGENT_MODEL} per the "Subagent Model" section. For any value still unresolved from invocation flags, ask the user via a single AskUserQuestion tool call containing only the unresolved questions (skip the call entirely if both were resolved from flags).
Output discipline (mandatory): Between the banner block and the AskUserQuestion invocation, emit no user-facing text whatsoever — no "I'll ask about…", no "loading the tool…", no acknowledgement that flags were missing. If AskUserQuestion's schema needs to be fetched via ToolSearch first, do that silently as well. The user should see banner → selection UI → resolved-values lines, with nothing in between. This overrides the default behavior of narrating intent before tool calls.
- Question for
{MODE}—header: "Run mode",question: "How should I run?", options:label: "Automatic (Recommended)",description: "Run end-to-end with no prompts."label: "Guided",description: "Pause at 7 checkpoints: extra docs, entry-point picker (browser UI), cost confirm, setup review, per-cycle coverage decision, property review, fuzzer choice."
- Question for
{AGENT_MODEL}—header: "Subagent model",question: "Which model should drive the subagents?", options:label: "Sonnet (Recommended)",description: "Default. Faster and cheaper for the 5 discovery agents, synthesizer, and 2 implementers."label: "Opus",description: "Higher quality but ~10× the cost. Equivalent to passing --max / --opus."
Map the user's selections back to {MODE} (automatic / guided) and {AGENT_MODEL} (sonnet / opus), then print these two lines so the resolved values are visible in transcript:
Mode: guidedorMode: automatic— the resolved{MODE}.Subagent model: sonnet(default) orSubagent model: opus (--max)(if--max/--opus/ "max quality" / "use opus" / Opus selection was requested).
Step 1: Verify Tooling And Environment
Run sequentially:
- Read template-map.md.
- Run
forge --version. - If
forge --versionfails, tell the user that Foundry is missing and suggest installing it using the official documentation: Foundry install guide:https://www.getfoundry.sh/introduction/installation - If
forge --versionfails, stop here. Foundry is required before proceeding with the rest of the workflow. - Run
bash {SKILL_PATH}/scripts/ensure_foundry.sh {PROJECT_ROOT}. - If
foundry.tomlis missing, allowensure_foundry.shto create one. If it fails, stop and report the error. - Run
medusa --version. - Run
echidna --version. - If either command fails, tell the user which tool is missing and suggest installing it using the official documentation:
Medusa install guide:
https://secure-contracts.com/program-analysis/medusa/docs/src/getting_started/installation.htmlEchidna install guide:https://secure-contracts.com/program-analysis/echidna/introduction/installation.html - If
medusa --versionfails, stop here. Medusa is required before proceeding with the rest of the workflow. - If
echidna --versionfails but Foundry and Medusa are installed, you may continue, but keep the installation recommendation in the user-facing summary because Echidna is still expected for the full workflow.
Step 2: Compile And Extract
Run sequentially:
- Read
{PROJECT_ROOT}/foundry.toml. - Run
cd {PROJECT_ROOT} && forge build. - Run
node {SKILL_PATH}/scripts/extract_abis.js {PROJECT_ROOT} --meta-dir {META_DIR}.
Step 3: Understand The Protocol
This step exists to drive setup, handler selection, and invariant generation quality.
If {MODE} = "guided", before touching any analysis source first ask the user: "Any additional docs, links, whitepapers, spec files, or prior-audit notes I should consider? (paste paths or URLs, or reply 'none')". If the user provides anything, write the raw list to {PROJECT_ROOT}/{META_DIR}/additional-context.md (one entry per line, include URLs verbatim). Later sub-steps of this step — and Step 9a — must read that file if it exists and fold it into the protocol-understanding context.
Start by checking whether {PROJECT_ROOT}/x-ray/ exists and contains x-ray.md. x-ray.md is REQUIRED — without it, x-ray output is considered unavailable regardless of which other files are present.
If {PROJECT_ROOT}/x-ray/x-ray.md exists, read it first as the primary project-understanding source. Then also read any of these supplementary files present in {PROJECT_ROOT}/x-ray/:
If {PROJECT_ROOT}/x-ray/x-ray.md does NOT exist, you MUST run the x-ray Acquisition Protocol below. The Protocol Analyzer fallback (Attempt 4) is FORBIDDEN until Attempts 1–3 have each been executed and their outcomes recorded in /tmp/x-ray-attempts.md. "I think x-ray isn't available" is NOT a valid skip — only the recorded output of an actual tool/command counts.
x-ray Acquisition Protocol
Before Attempt 1, delete /tmp/x-ray-attempts.md if it exists (rm -f /tmp/x-ray-attempts.md) — stale entries from a previous run would falsely satisfy the Attempt 4 gate. Then create a fresh /tmp/x-ray-attempts.md and append one entry per attempt: timestamp, attempt name, command/tool invoked, exact output (or "no output"), outcome (SUCCESS / FAILED: {reason} / SKIPPED: {reason}). Attempt 4 requires the file to contain exactly 3 entries (one per Attempt 1, 2, 3) — SKIPPED entries count toward this total.
- Attempt 1 — invoke the skill. Call the
x-rayskill via theSkilltool withargs="{PROJECT_ROOT}". Do NOT pre-judge availability — invoke it. Only a runtime error of the form "skill not found" / "unknown skill" counts as unavailable. If it runs, wait for completion, then verify{PROJECT_ROOT}/x-ray/x-ray.mdwas written. If yes → SUCCESS, exit Protocol. - Attempt 2 — install from the official source and re-invoke. Run:
Then re-invokegit clone --depth 1 https://github.com/pashov/skills.git /tmp/pashov-skills-xray-install \ && mkdir -p ~/.claude/skills \ && cp -r /tmp/pashov-skills-xray-install/x-ray ~/.claude/skills/x-raySkill('x-ray', args="{PROJECT_ROOT}"). If{PROJECT_ROOT}/x-ray/x-ray.mdis produced → SUCCESS, exit Protocol. If the re-invocation still returns "skill not found" / "unknown skill" (auto-discovery did not pick up the freshly installed skill mid-session), do NOT mark this attempt failed yet — instead read~/.claude/skills/x-ray/SKILL.md(or/tmp/pashov-skills-xray-install/x-ray/SKILL.md) and execute its instructions inline against{PROJECT_ROOT}. If that produces{PROJECT_ROOT}/x-ray/x-ray.md→ SUCCESS, exit Protocol. Only if ALL of (Skill re-invocation, inline execution) fail does this attempt count as FAILED. - Attempt 3 — guided-mode user gate (guided only). If
{MODE} = "guided"AND Attempts 1–2 both failed, ASK the user: "Could not obtain x-ray automatically (logs in/tmp/x-ray-attempts.md). Options: (a) paste an x-ray.md path, (b) authorize Protocol Analyzer fallback, (c) abort. Choose a/b/c." Record their answer
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
