fuzzing-dictionary

Provide domain-specific tokens to guide fuzzers during input mutation.

Updated Jul 10, 2025
One-click install
npx skills add https://github.com/Superlend/superloop-core-contracts --skill fuzzing-dictionary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fuzzing-dictionary
Source: https://github.com/Superlend/superloop-core-contracts/tree/main/.cursor/skills/testing-handbook-skills/skills/fuzzing-dictionary
Command: npx skills add https://github.com/Superlend/superloop-core-contracts --skill fuzzing-dictionary

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fuzzing dictionaries provide domain-specific tokens to guide fuzzers away from trivial inputs and toward meaningful edge cases, accelerating discovery of parser, protocol, and format vulnerabilities.

Core Features & Use Cases

  • Structured Token Library: A collection of keywords, magic numbers, and protocol tokens to steer input mutations.
  • Cross-Format Coverage: Applicable to parsers, protocols, and file format decoders to reach deeper logic.
  • Easy Quick Start: Simple steps to create a token dictionary and integrate with popular fuzzers.
  • Practical Use: Improve fuzzing effectiveness for JSON/XML configs, HTTP handlers, and binary decoders.

Quick Start

Create a text dictionary with quoted strings (one per line), save as dictionary.dict, and run your fuzzer with the appropriate flag:

  • libFuzzer: ./fuzz -dict=./dictionary.dict
  • AFL++: afl-fuzz -x ./dictionary.dict
  • cargo-fuzz: cargo fuzz run fuzz_target -- -dict=./dictionary.dict

Frequently Asked Questions about fuzzing-dictionary

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use a fuzzing dictionary to improve parser testing?

A fuzzing dictionary improves parser testing by providing domain-specific tokens that guide fuzzers toward meaningful edge cases, accelerating the discovery of vulnerabilities in file format decoders and protocols.

What is the best way to create a fuzzing dictionary for libFuzzer?

Create a text file containing quoted strings, with one token per line, and save it as a .dict file. Integrate this fuzzing dictionary into libFuzzer by running your fuzz target with the -dict flag pointing to the file.

Does a fuzzing dictionary work with AFL++ and cargo-fuzz workflows?

Yes, a fuzzing dictionary works with AFL++ and cargo-fuzz workflows. You can supply the dictionary file using the -x flag for AFL++ and the -dict flag for cargo-fuzz to guide input mutations.

Why does my fuzzer only find trivial inputs without a dictionary?

Fuzzers often find only trivial inputs without a dictionary because they lack domain-specific tokens like magic numbers and keywords, preventing them from reaching deeper logic paths in complex parsers and protocols.

When do I need a fuzzing dictionary for security testing?

You need a fuzzing dictionary for security testing when targeting parsers, protocols, or file format decoders, as it provides structured tokens that steer input mutation toward meaningful edge cases and vulnerabilities.