← Explore all skills

TESTING / trailofbits

Ruzzy Ruby Fuzzing

Create Ruby and native-extension fuzz harnesses with coverage tracing and sanitizer-aware execution.

“Sets up and runs Ruzzy, Trail of Bits' coverage-guided Ruby fuzzer and the only production-ready one for the language. Covers harness structure, fuzzing pure Ruby”

01 / THE REASONING

Why this made the selection.

  • The handbook is specifically for Ruzzy, and it says pure Ruby needs a second tracer script that C-extension fuzzing does not.
  • Native support is Linux x86-64 and AArch64. macOS and Windows are sent to the project's Docker image rather than a local install.
  • The inspected Ruby examples distinguish pure-language tracing from native-extension harnesses and show inline sanitizer loading and crash artifacts.
  • Fuzz pure Ruby parsing through a separate tracer script

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • plugins/testing-handbook-skills/skills/ruzzy/SKILL.md
  • LICENSE
  • README.md

Our findings

  • Runs are local Ruby processes. The file points macOS and Windows at an upstream Dockerfile instead of claiming a native run.
  • Sanitizer injection uses LD_PRELOAD on the ruby command. Exporting that variable is forbidden in the note.
  • It does not fuzz Python or JavaScript, and pure Ruby is not the same one-script harness as a C extension.
  • The inspected Ruby examples distinguish pure-language tracing from native-extension harnesses and show inline sanitizer loading and crash artifacts.

Not established by this review

  • The resource was not executed and its tools were not called.
  • Ruzzy was not installed and no Ruby harness was run.
  • No skill execution, authenticated service operation, or outcome benchmark was performed.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx skills add trailofbits/skills/plugins/testing-handbook-skills/skills/ruzzy

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills add https://github.com/trailofbits/skills/tree/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/testing-handbook-skills/skills/ruzzy
  1. Install the pinned skill directory interactively, retaining its bundled references and scripts.
  2. Build Ruzzy and target extensions with compatible Clang settings, then confirm the toy crash works before using a real target.
  3. Set LD_PRELOAD per invocation rather than exporting it globally; preserve crashing inputs and replay them.

Before you start

  • Linux x86-64 or ARM64, or the publisher container workflow
  • Ruby, gems and a compatible Clang toolchain

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. Pinned skill definition ↗Checked

    https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/testing-handbook-skills/skills/ruzzy/SKILL.md

    Supports: summary, whySelected, bestFor, limitations, install, access, review

  2. https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md

    Supports: install

  3. CC-BY-SA-4.0 licence ↗Checked

    https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE

    Supports: license

Evidence & Ask