[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CHEFE81PXVYHTSAPCVB3TY":3,"skill-same:01M7CHEFE81PXVYHTSAPCVB3TY":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7CHEFE81PXVYHTSAPCVB3TY","ossfuzz",null,"Enrolls a project in OSS-Fuzz, Google's free continuous fuzzing service for open source, and drives it locally. Covers project.yaml, Dockerfile and build.sh setup, the helper scripts, reproducing OSS-Fuzz crash reports, and the acceptance criteria. Use when setting up continuous fuzzing for an open-source project, reproducing an OSS-Fuzz bug report, or testing an OSS-Fuzz build before submitting it.","bongkage\u002Ftrailofbits-skills","bongkage","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F101378796?v=4","01M7CH419QTJ16DNJ33P0WCWBE","01M7CH41A9NWK8D2JBRK9F0M2C",1,"CC-BY-SA-4.0","https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Ftesting-handbook-skills\u002Fskills\u002Fossfuzz\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ossfuzz\ntype: technique\ndescription: \"Enrolls a project in OSS-Fuzz, Google's free continuous fuzzing service for open source, and drives it locally. Covers project.yaml, Dockerfile and build.sh setup, the helper scripts, reproducing OSS-Fuzz crash reports, and the acceptance criteria. Use when setting up continuous fuzzing for an open-source project, reproducing an OSS-Fuzz bug report, or testing an OSS-Fuzz build before submitting it.\"\n---\n\n# OSS-Fuzz\n\n[OSS-Fuzz](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002F) is an open-source project developed by Google that provides free distributed infrastructure for continuous fuzz testing. It streamlines the fuzzing process and facilitates simpler modifications. While only select projects are accepted into OSS-Fuzz, the project's core is open-source, allowing anyone to host their own instance for private projects.\n\n## Overview\n\nOSS-Fuzz provides a simple CLI framework for building and starting harnesses or calculating their coverage. Additionally, OSS-Fuzz can be used as a service that hosts static web pages generated from fuzzing outputs such as coverage information.\n\n### Key Concepts\n\n| Concept | Description |\n|---------|-------------|\n| **helper.py** | CLI script for building images, building fuzzers, and running harnesses locally |\n| **Base Images** | Hierarchical Docker images providing build dependencies and compilers |\n| **project.yaml** | Configuration file defining project metadata for OSS-Fuzz enrollment |\n| **Dockerfile** | Project-specific image with build dependencies |\n| **build.sh** | Script that builds fuzzing harnesses for your project |\n| **Criticality Score** | Metric used by OSS-Fuzz team to evaluate project acceptance |\n\n## When to Apply\n\n**Apply this technique when:**\n- Setting up continuous fuzzing for an open-source project\n- Need distributed fuzzing infrastructure without managing servers\n- Want coverage reports and bug tracking integrated with fuzzing\n- Testing existing OSS-Fuzz harnesses locally\n- Reproducing crashes from OSS-Fuzz bug reports\n\n**Skip this technique when:**\n- Project is closed-source (unless hosting your own OSS-Fuzz instance)\n- Project doesn't meet OSS-Fuzz's criticality score threshold\n- Need proprietary or specialized fuzzing infrastructure\n- Fuzzing simple scripts that don't warrant infrastructure\n\n## Quick Reference\n\n| Task | Command |\n|------|---------|\n| Clone OSS-Fuzz | `git clone https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz` |\n| Build project image | `uv run --no-project python infra\u002Fhelper.py build_image --pull \u003Cproject>` |\n| Build fuzzers with ASan | `uv run --no-project python infra\u002Fhelper.py build_fuzzers --sanitizer=address \u003Cproject>` |\n| Run specific harness | `uv run --no-project python infra\u002Fhelper.py run_fuzzer \u003Cproject> \u003Charness>` |\n| Generate coverage report | `uv run --no-project python infra\u002Fhelper.py coverage \u003Cproject>` |\n| Check helper.py options | `uv run --no-project python infra\u002Fhelper.py --help` |\n\n## OSS-Fuzz Project Components\n\nOSS-Fuzz provides several publicly available tools and web interfaces:\n\n### Bug Tracker\n\nThe [bug tracker](https:\u002F\u002Fissues.oss-fuzz.com\u002Fissues?q=status:open) allows you to:\n- Check bugs from specific projects (initially visible only to maintainers, later [made public](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002Fgetting-started\u002Fbug-disclosure-guidelines\u002F))\n- Create new issues and comment on existing ones\n- Search for similar bugs across **all projects** to understand issues\n\n### Build Status System\n\nThe [build status system](https:\u002F\u002Foss-fuzz-build-logs.storage.googleapis.com\u002Findex.html) helps track:\n- Build statuses of all included projects\n- Date of last successful build\n- Build failures and their duration\n\n### Fuzz Introspector\n\n[Fuzz Introspector](https:\u002F\u002Foss-fuzz-introspector.storage.googleapis.com\u002Findex.html) displays:\n- Coverage data for projects enrolled in OSS-Fuzz\n- Hit frequency for covered code\n- Performance analysis and blocker identification\n\nRead [this case study](https:\u002F\u002Fgithub.com\u002Fossf\u002Ffuzz-introspector\u002Fblob\u002Fmain\u002Fdoc\u002FCaseStudies.md) for examples and explanations.\n\n## Step-by-Step: Running a Single Harness\n\nYou don't need to host the whole OSS-Fuzz platform to use it. The helper script makes it easy to run individual harnesses locally.\n\n### Step 1: Clone OSS-Fuzz\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\ncd oss-fuzz\nuv run --no-project python infra\u002Fhelper.py --help\n```\n\n### Step 2: Build Project Image\n\n```bash\nuv run --no-project python infra\u002Fhelper.py build_image --pull \u003Cproject-name>\n```\n\nThis downloads and builds the base Docker image for the project.\n\n### Step 3: Build Fuzzers with Sanitizers\n\n```bash\nuv run --no-project python infra\u002Fhelper.py build_fuzzers --sanitizer=address \u003Cproject-name>\n```\n\n**Sanitizer options:**\n- `--sanitizer=address` for [AddressSanitizer](https:\u002F\u002Fappsec.guide\u002Fdocs\u002Ffuzzing\u002Ftechniques\u002Fasan\u002F) with [LeakSanitizer](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fsanitizers\u002Fwiki\u002FAddressSanitizerLeakSanitizer)\n- Other sanitizers available (language support varies)\n\n**Note:** Fuzzers are built to `\u002Fbuild\u002Fout\u002F\u003Cproject-name>\u002F` containing the harness executables, dictionaries, corpus, and crash files.\n\n### Step 4: Run the Fuzzer\n\n```bash\nuv run --no-project python infra\u002Fhelper.py run_fuzzer \u003Cproject-name> \u003Charness-name> [\u003Cfuzzer-args>]\n```\n\nThe helper script automatically runs any missed steps if you skip them.\n\n### Step 5: Coverage Analysis (Optional)\n\nFirst, [install gsutil](https:\u002F\u002Fcloud.google.com\u002Fstorage\u002Fdocs\u002Fgsutil_install) (skip gcloud initialization).\n\n```bash\nuv run --no-project python infra\u002Fhelper.py build_fuzzers --sanitizer=coverage \u003Cproject-name>\nuv run --no-project python infra\u002Fhelper.py coverage \u003Cproject-name>\n```\n\nUse `--no-corpus-download` to use only local corpus. The command generates and hosts a coverage report locally.\n\nSee [official OSS-Fuzz documentation](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002Fadvanced-topics\u002Fcode-coverage\u002F) for details.\n\n## Common Patterns\n\n### Pattern: Running irssi Example\n\n**Use Case:** Testing OSS-Fuzz setup with a simple enrolled project\n\n```bash\n# Clone and navigate to OSS-Fuzz\ngit clone https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\ncd oss-fuzz\n\n# Build and run irssi fuzzer\nuv run --no-project python infra\u002Fhelper.py build_image --pull irssi\nuv run --no-project python infra\u002Fhelper.py build_fuzzers --sanitizer=address irssi\nuv run --no-project python infra\u002Fhelper.py run_fuzzer irssi irssi-fuzz\n```\n\n**Expected Output:**\n```\nINFO:__main__:Running: docker run --rm --privileged --shm-size=2g --platform linux\u002Famd64 -i -e FUZZING_ENGINE=libfuzzer -e SANITIZER=address -e RUN_FUZZER_MODE=interactive -e HELPER=True -v \u002Fprivate\u002Ftmp\u002Foss-fuzz\u002Fbuild\u002Fout\u002Firssi:\u002Fout -t gcr.io\u002Foss-fuzz-base\u002Fbase-runner run_fuzzer irssi-fuzz.\nUsing seed corpus: irssi-fuzz_seed_corpus.zip\n\u002Fout\u002Firssi-fuzz -rss_limit_mb=2560 -timeout=25 \u002Ftmp\u002Firssi-fuzz_corpus -max_len=2048 \u003C \u002Fdev\u002Fnull\nINFO: Running with entropic power schedule (0xFF, 100).\nINFO: Seed: 1531341664\nINFO: Loaded 1 modules   (95687 inline 8-bit counters): 95687 [0x1096c80, 0x10ae247),\nINFO: Loaded 1 PC tables (95687 PCs): 95687 [0x10ae248,0x1223eb8),\nINFO:      719 files found in \u002Ftmp\u002Firssi-fuzz_corpus\nINFO: seed corpus: files: 719 min: 1b max: 170106b total: 367969b rss: 48Mb\n#720        INITED cov: 409 ft: 1738 corp: 640\u002F163Kb exec\u002Fs: 0 rss: 62Mb\n#762        REDUCE cov: 409 ft: 1738 corp: 640\u002F163Kb lim: 2048 exec\u002Fs: 0 rss: 63Mb L: 236\u002F2048 MS: 2 ShuffleBytes-EraseBytes-\n```\n\n### Pattern: Enrolling a New Project\n\n**Use Case:** Adding your project to OSS-Fuzz (or private instance)\n\nCreate three files in `projects\u002F\u003Cyour-project>\u002F`:\n\n**1. project.yaml** - Project metadata:\n```yaml\nhomepage: \"https:\u002F\u002Fgithub.com\u002Fyourorg\u002Fyourproject\"\nlanguage: c++\nprimary_contact: \"your-email@example.com\"\nmain_repo: \"https:\u002F\u002Fgithub.com\u002Fyourorg\u002Fyourproject\"\nfuzzing_engines:\n  - libfuzzer\nsanitizers:\n  - address\n  - undefined\n```\n\n**2. Dockerfile** - Build dependencies:\n```dockerfile\nFROM gcr.io\u002Foss-fuzz-base\u002Fbase-builder\nRUN apt-get update && apt-get install -y \\\n    autoconf \\\n    automake \\\n    libtool \\\n    pkg-config\nRUN git clone --depth 1 https:\u002F\u002Fgithub.com\u002Fyourorg\u002Fyourproject\nWORKDIR yourproject\nCOPY build.sh $SRC\u002F\n```\n\n**3. build.sh** - Build harnesses:\n```bash\n#!\u002Fbin\u002Fbash -eu\n.\u002Fautogen.sh\n.\u002Fconfigure --disable-shared\nmake -j$(nproc)\n\n# Build harnesses\n$CXX $CXXFLAGS -std=c++11 -I. \\\n    $SRC\u002Fyourproject\u002Ffuzz\u002Fharness.cc -o $OUT\u002Fharness \\\n    $LIB_FUZZING_ENGINE .\u002Flibyourproject.a\n\n# Copy corpus and dictionary if available\ncp $SRC\u002Fyourproject\u002Ffuzz\u002Fcorpus.zip $OUT\u002Fharness_seed_corpus.zip\ncp $SRC\u002Fyourproject\u002Ffuzz\u002Fdictionary.dict $OUT\u002Fharness.dict\n```\n\n## Docker Images in OSS-Fuzz\n\nHarnesses are built and executed in Docker containers. All projects share a runner image, but each project has its own build image.\n\n### Image Hierarchy\n\nImages build on each other in this sequence:\n\n1. **[base_image](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Fblob\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-image\u002FDockerfile)** - Specific Ubuntu version\n2. **[base_clang](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-clang)** - Clang compiler; based on `base_image`\n3. **[base_builder](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-builder)** - Build dependencies; based on `base_clang`\n   - Language-specific variants: [`base_builder_go`](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-builder-go), etc.\n   - See [\u002Foss-fuzz\u002Finfra\u002Fbase-images\u002F](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images) for full list\n4. **Your project Docker image** - Project-specific dependencies; based on `base_builder` or language variant\n\n### Runner Images (Used Separately)\n\n- **[base_runner](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-runner)** - Executes harnesses; based on `base_clang`\n- **[base_runner_debug](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-runner-debug)** - With debug tools; based on `base_runner`\n\n## Advanced Usage\n\n### Tips and Tricks\n\n| Tip | Why It Helps |\n|-----|--------------|\n| **Don't manually copy source code** | Project Dockerfile likely already pulls latest version |\n| **Check existing projects** | Browse [oss-fuzz\u002Fprojects](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Fprojects) for examples |\n| **Keep harnesses in separate repo** | Like [curl-fuzzer](https:\u002F\u002Fgithub.com\u002Fcurl\u002Fcurl-fuzzer) - cleaner organization |\n| **Use specific compiler versions** | Base images provide consistent build environment |\n| **Install dependencies in Dockerfile** | May require approval for OSS-Fuzz enrollment |\n\n### Criticality Score\n\nOSS-Fuzz uses a [criticality score](https:\u002F\u002Fgithub.com\u002Fossf\u002Fcriticality_score) to evaluate project acceptance. See [this example](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Fpull\u002F11444#issuecomment-1875907472) for how scoring works.\n\nProjects with lower scores may still be added to private OSS-Fuzz instances.\n\n### Hosting Your Own Instance\n\nSince OSS-Fuzz is open-source, you can host your own instance for:\n- Private projects not eligible for public OSS-Fuzz\n- Projects with lower criticality scores\n- Custom fuzzing infrastructure needs\n\n## Anti-Patterns\n\n| Anti-Pattern | Problem | Correct Approach |\n|--------------|---------|------------------|\n| **Manually pulling source in build.sh** | Doesn't use latest version | Let Dockerfile handle git clone |\n| **Copying code to OSS-Fuzz repo** | Hard to maintain, violates separation | Reference external harness repo |\n| **Ignoring base image versions** | Build inconsistencies | Use provided base images and compilers |\n| **Skipping local testing** | Wastes CI resources | Use helper.py locally before PR |\n| **Not checking build status** | Unnoticed build failures | Monitor build status page regularly |\n\n## Tool-Specific Guidance\n\n### libFuzzer\n\nOSS-Fuzz primarily uses libFuzzer as the fuzzing engine for C\u002FC++ projects.\n\n**Harness signature:**\n```c++\nextern \"C\" int LLVMFuzzerTestOneInput(const uint8_t *data, size_t size) {\n    \u002F\u002F Your fuzzing logic\n    return 0;\n}\n```\n\n**Build in build.sh:**\n```bash\n$CXX $CXXFLAGS -std=c++11 -I. \\\n    harness.cc -o $OUT\u002Fharness \\\n    $LIB_FUZZING_ENGINE .\u002Flibproject.a\n```\n\n**Integration tips:**\n- Use `$LIB_FUZZING_ENGINE` variable provided by OSS-Fuzz\n- Include `-fsanitize=fuzzer` is handled automatically\n- Link against static libraries when possible\n\n### AFL++\n\nOSS-Fuzz supports AFL++ as an alternative fuzzing engine.\n\n**Enable in project.yaml:**\n```yaml\nfuzzing_engines:\n  - afl\n  - libfuzzer\n```\n\n**Integration tips:**\n- AFL++ harnesses work alongside libFuzzer harnesses\n- Use persistent mode for better performance\n- OSS-Fuzz handles engine-specific compilation flags\n\n### Atheris (Python)\n\nFor Python projects with C extensions.\n\n**Example from [cbor2 integration](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Fpull\u002F11444):**\n\n**Harness:**\n```python\nimport atheris\nimport sys\nimport cbor2\n\n@atheris.instrument_func\ndef TestOneInput(data):\n    fdp = atheris.FuzzedDataProvider(data)\n    try:\n        cbor2.loads(data)\n    except (cbor2.CBORDecodeError, ValueError):\n        pass\n\ndef main():\n    atheris.Setup(sys.argv, TestOneInput)\n    atheris.Fuzz()\n\nif __name__ == \"__main__\":\n    main()\n```\n\n**Build in build.sh:**\n```bash\n# allow-legacy-python: build.sh runs inside the oss-fuzz container, where the shims are absent.\npip3 install .\nfor fuzzer in $(find $SRC -name 'fuzz_*.py'); do\n  compile_python_fuzzer $fuzzer\ndone\n```\n\n**Integration tips:**\n- Use `compile_python_fuzzer` helper provided by OSS-Fuzz\n- See [Continuously Fuzzing Python C Extensions](https:\u002F\u002Fblog.trailofbits.com\u002F2024\u002F02\u002F23\u002Fcontinuously-fuzzing-python-c-extensions\u002F) blog post\n\n### Rust Projects\n\n**Enable in project.yaml:**\n```yaml\nlanguage: rust\nfuzzing_engines:\n  - libfuzzer\nsanitizers:\n  - address  # Only AddressSanitizer supported for Rust\n```\n\n**Build in build.sh:**\n```bash\ncargo fuzz build -O --debug-assertions\ncp fuzz\u002Ftarget\u002Fx86_64-unknown-linux-gnu\u002Frelease\u002Ffuzz_target_1 $OUT\u002F\n```\n\n**Integration tips:**\n- [Rust supports only AddressSanitizer with libfuzzer](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002Fgetting-started\u002Fnew-project-guide\u002Frust-lang\u002F#projectyaml)\n- Use cargo-fuzz for local development\n- OSS-Fuzz handles Rust-specific compilation\n\n## Troubleshooting\n\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| **Build fails with missing dependencies** | Dependencies not in Dockerfile | Add `apt-get install` or equivalent in Dockerfile |\n| **Harness crashes immediately** | Missing input validation | Add size checks in harness |\n| **Coverage is 0%** | Harness not reaching target code | Verify harness actually calls target functions |\n| **Build timeout** | Complex build process | Optimize build.sh, consider parallel builds |\n| **Sanitizer errors in build** | Incompatible flags | Use flags provided by OSS-Fuzz environment variables |\n| **Cannot find source code** | Wrong working directory in Dockerfile | Set WORKDIR or use absolute paths |\n\n## Related Skills\n\n### Tools That Use This Technique\n\n| Skill | How It Applies |\n|-------|----------------|\n| **libfuzzer** | Primary fuzzing engine used by OSS-Fuzz |\n| **aflpp** | Alternative fuzzing engine supported by OSS-Fuzz |\n| **atheris** | Used for fuzzing Python projects in OSS-Fuzz |\n| **cargo-fuzz** | Used for Rust projects in OSS-Fuzz |\n\n### Related Techniques\n\n| Skill | Relationship |\n|-------|--------------|\n| **coverage-analysis** | OSS-Fuzz generates coverage reports via helper.py |\n| **address-sanitizer** | Default sanitizer for OSS-Fuzz projects |\n| **fuzz-harness-writing** | Essential for enrolling projects in OSS-Fuzz |\n| **corpus-management** | OSS-Fuzz maintains corpus for enrolled projects |\n\n## Resources\n\n### Key External Resources\n\n**[OSS-Fuzz Official Documentation](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002F)**\nComprehensive documentation covering enrollment, harness writing, and troubleshooting for the OSS-Fuzz platform.\n\n**[Getting Started Guide](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002Fgetting-started\u002Faccepting-new-projects\u002F)**\nStep-by-step process for enrolling new projects into OSS-Fuzz, including requirements and approval process.\n\n**[cbor2 OSS-Fuzz Integration PR](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Fpull\u002F11444)**\nReal-world example of enrolling a Python project with C extensions into OSS-Fuzz. Shows:\n- Initial proposal and project introduction\n- Criticality score evaluation\n- Complete implementation (project.yaml, Dockerfile, build.sh, harnesses)\n\n**[Fuzz Introspector Case Studies](https:\u002F\u002Fgithub.com\u002Fossf\u002Ffuzz-introspector\u002Fblob\u002Fmain\u002Fdoc\u002FCaseStudies.md)**\nExamples and explanations of using Fuzz Introspector to analyze coverage and identify fuzzing blockers.\n\n### Video Resources\n\nCheck OSS-Fuzz documentation for workshop recordings and tutorials on enrollment and harness development.\n","# OSS-Fuzz\n\n[OSS-Fuzz](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002F) is an open-source project developed by Google that provides free distributed infrastructure for continuous fuzz testing. It streamlines the fuzzing process and facilitates simpler modifications. While only select projects are accepted into OSS-Fuzz, the project's core is open-source, allowing anyone to host their own instance for private projects.\n\n## Overview\n\nOSS-Fuzz provides a simple CLI framework for building and starting harnesses or calculating their coverage. Additionally, OSS-Fuzz can be used as a service that hosts static web pages generated from fuzzing outputs such as coverage information.\n\n### Key Concepts\n\n| Concept | Description |\n|---------|-------------|\n| **helper.py** | CLI script for building images, building fuzzers, and running harnesses locally |\n| **Base Images** | Hierarchical Docker images providing build dependencies and compilers |\n| **project.yaml** | Configuration file defining project metadata for OSS-Fuzz enrollment |\n| **Dockerfile** | Project-specific image with build dependencies |\n| **build.sh** | Script that builds fuzzing harnesses for your project |\n| **Criticality Score** | Metric used by OSS-Fuzz team to evaluate project acceptance |\n\n## When to Apply\n\n**Apply this technique when:**\n- Setting up continuous fuzzing for an open-source project\n- Need distributed fuzzing infrastructure without managing servers\n- Want coverage reports and bug tracking integrated with fuzzing\n- Testing existing OSS-Fuzz harnesses locally\n- Reproducing crashes from OSS-Fuzz bug reports\n\n**Skip this technique when:**\n- Project is closed-source (unless hosting your own OSS-Fuzz instance)\n- Project doesn't meet OSS-Fuzz's criticality score threshold\n- Need proprietary or specialized fuzzing infrastructure\n- Fuzzing simple scripts that don't warrant infrastructure\n\n## Quick Reference\n\n| Task | Command |\n|------|---------|\n| Clone OSS-Fuzz | `git clone https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz` |\n| Build project image | `uv run --no-project python infra\u002Fhelper.py build_image --pull \u003Cproject>` |\n| Build fuzzers with ASan | `uv run --no-project python infra\u002Fhelper.py build_fuzzers --sanitizer=address \u003Cproject>` |\n| Run specific harness | `uv run --no-project python infra\u002Fhelper.py run_fuzzer \u003Cproject> \u003Charness>` |\n| Generate coverage report | `uv run --no-project python infra\u002Fhelper.py coverage \u003Cproject>` |\n| Check helper.py options | `uv run --no-project python infra\u002Fhelper.py --help` |\n\n## OSS-Fuzz Project Components\n\nOSS-Fuzz provides several publicly available tools and web interfaces:\n\n### Bug Tracker\n\nThe [bug tracker](https:\u002F\u002Fissues.oss-fuzz.com\u002Fissues?q=status:open) allows you to:\n- Check bugs from specific projects (initially visible only to maintainers, later [made public](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002Fgetting-started\u002Fbug-disclosure-guidelines\u002F))\n- Create new issues and comment on existing ones\n- Search for similar bugs across **all projects** to understand issues\n\n### Build Status System\n\nThe [build status system](https:\u002F\u002Foss-fuzz-build-logs.storage.googleapis.com\u002Findex.html) helps track:\n- Build statuses of all included projects\n- Date of last successful build\n- Build failures and their duration\n\n### Fuzz Introspector\n\n[Fuzz Introspector](https:\u002F\u002Foss-fuzz-introspector.storage.googleapis.com\u002Findex.html) displays:\n- Coverage data for projects enrolled in OSS-Fuzz\n- Hit frequency for covered code\n- Performance analysis and blocker identification\n\nRead [this case study](https:\u002F\u002Fgithub.com\u002Fossf\u002Ffuzz-introspector\u002Fblob\u002Fmain\u002Fdoc\u002FCaseStudies.md) for examples and explanations.\n\n## Step-by-Step: Running a Single Harness\n\nYou don't need to host the whole OSS-Fuzz platform to use it. The helper script makes it easy to run individual harnesses locally.\n\n### Step 1: Clone OSS-Fuzz\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\ncd oss-fuzz\nuv run --no-project python infra\u002Fhelper.py --help\n```\n\n### Step 2: Build Project Image\n\n```bash\nuv run --no-project python infra\u002Fhelper.py build_image --pull \u003Cproject-name>\n```\n\nThis downloads and builds the base Docker image for the project.\n\n### Step 3: Build Fuzzers with Sanitizers\n\n```bash\nuv run --no-project python infra\u002Fhelper.py build_fuzzers --sanitizer=address \u003Cproject-name>\n```\n\n**Sanitizer options:**\n- `--sanitizer=address` for [AddressSanitizer](https:\u002F\u002Fappsec.guide\u002Fdocs\u002Ffuzzing\u002Ftechniques\u002Fasan\u002F) with [LeakSanitizer](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fsanitizers\u002Fwiki\u002FAddressSanitizerLeakSanitizer)\n- Other sanitizers available (language support varies)\n\n**Note:** Fuzzers are built to `\u002Fbuild\u002Fout\u002F\u003Cproject-name>\u002F` containing the harness executables, dictionaries, corpus, and crash files.\n\n### Step 4: Run the Fuzzer\n\n```bash\nuv run --no-project python infra\u002Fhelper.py run_fuzzer \u003Cproject-name> \u003Charness-name> [\u003Cfuzzer-args>]\n```\n\nThe helper script automatically runs any missed steps if you skip them.\n\n### Step 5: Coverage Analysis (Optional)\n\nFirst, [install gsutil](https:\u002F\u002Fcloud.google.com\u002Fstorage\u002Fdocs\u002Fgsutil_install) (skip gcloud initialization).\n\n```bash\nuv run --no-project python infra\u002Fhelper.py build_fuzzers --sanitizer=coverage \u003Cproject-name>\nuv run --no-project python infra\u002Fhelper.py coverage \u003Cproject-name>\n```\n\nUse `--no-corpus-download` to use only local corpus. The command generates and hosts a coverage report locally.\n\nSee [official OSS-Fuzz documentation](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002Fadvanced-topics\u002Fcode-coverage\u002F) for details.\n\n## Common Patterns\n\n### Pattern: Running irssi Example\n\n**Use Case:** Testing OSS-Fuzz setup with a simple enrolled project\n\n```bash\n# Clone and navigate to OSS-Fuzz\ngit clone https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\ncd oss-fuzz\n\n# Build and run irssi fuzzer\nuv run --no-project python infra\u002Fhelper.py build_image --pull irssi\nuv run --no-project python infra\u002Fhelper.py build_fuzzers --sanitizer=address irssi\nuv run --no-project python infra\u002Fhelper.py run_fuzzer irssi irssi-fuzz\n```\n\n**Expected Output:**\n```\nINFO:__main__:Running: docker run --rm --privileged --shm-size=2g --platform linux\u002Famd64 -i -e FUZZING_ENGINE=libfuzzer -e SANITIZER=address -e RUN_FUZZER_MODE=interactive -e HELPER=True -v \u002Fprivate\u002Ftmp\u002Foss-fuzz\u002Fbuild\u002Fout\u002Firssi:\u002Fout -t gcr.io\u002Foss-fuzz-base\u002Fbase-runner run_fuzzer irssi-fuzz.\nUsing seed corpus: irssi-fuzz_seed_corpus.zip\n\u002Fout\u002Firssi-fuzz -rss_limit_mb=2560 -timeout=25 \u002Ftmp\u002Firssi-fuzz_corpus -max_len=2048 \u003C \u002Fdev\u002Fnull\nINFO: Running with entropic power schedule (0xFF, 100).\nINFO: Seed: 1531341664\nINFO: Loaded 1 modules   (95687 inline 8-bit counters): 95687 [0x1096c80, 0x10ae247),\nINFO: Loaded 1 PC tables (95687 PCs): 95687 [0x10ae248,0x1223eb8),\nINFO:      719 files found in \u002Ftmp\u002Firssi-fuzz_corpus\nINFO: seed corpus: files: 719 min: 1b max: 170106b total: 367969b rss: 48Mb\n#720        INITED cov: 409 ft: 1738 corp: 640\u002F163Kb exec\u002Fs: 0 rss: 62Mb\n#762        REDUCE cov: 409 ft: 1738 corp: 640\u002F163Kb lim: 2048 exec\u002Fs: 0 rss: 63Mb L: 236\u002F2048 MS: 2 ShuffleBytes-EraseBytes-\n```\n\n### Pattern: Enrolling a New Project\n\n**Use Case:** Adding your project to OSS-Fuzz (or private instance)\n\nCreate three files in `projects\u002F\u003Cyour-project>\u002F`:\n\n**1. project.yaml** - Project metadata:\n```yaml\nhomepage: \"https:\u002F\u002Fgithub.com\u002Fyourorg\u002Fyourproject\"\nlanguage: c++\nprimary_contact: \"your-email@example.com\"\nmain_repo: \"https:\u002F\u002Fgithub.com\u002Fyourorg\u002Fyourproject\"\nfuzzing_engines:\n  - libfuzzer\nsanitizers:\n  - address\n  - undefined\n```\n\n**2. Dockerfile** - Build dependencies:\n```dockerfile\nFROM gcr.io\u002Foss-fuzz-base\u002Fbase-builder\nRUN apt-get update && apt-get install -y \\\n    autoconf \\\n    automake \\\n    libtool \\\n    pkg-config\nRUN git clone --depth 1 https:\u002F\u002Fgithub.com\u002Fyourorg\u002Fyourproject\nWORKDIR yourproject\nCOPY build.sh $SRC\u002F\n```\n\n**3. build.sh** - Build harnesses:\n```bash\n#!\u002Fbin\u002Fbash -eu\n.\u002Fautogen.sh\n.\u002Fconfigure --disable-shared\nmake -j$(nproc)\n\n# Build harnesses\n$CXX $CXXFLAGS -std=c++11 -I. \\\n    $SRC\u002Fyourproject\u002Ffuzz\u002Fharness.cc -o $OUT\u002Fharness \\\n    $LIB_FUZZING_ENGINE .\u002Flibyourproject.a\n\n# Copy corpus and dictionary if available\ncp $SRC\u002Fyourproject\u002Ffuzz\u002Fcorpus.zip $OUT\u002Fharness_seed_corpus.zip\ncp $SRC\u002Fyourproject\u002Ffuzz\u002Fdictionary.dict $OUT\u002Fharness.dict\n```\n\n## Docker Images in OSS-Fuzz\n\nHarnesses are built and executed in Docker containers. All projects share a runner image, but each project has its own build image.\n\n### Image Hierarchy\n\nImages build on each other in this sequence:\n\n1. **[base_image](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Fblob\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-image\u002FDockerfile)** - Specific Ubuntu version\n2. **[base_clang](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-clang)** - Clang compiler; based on `base_image`\n3. **[base_builder](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-builder)** - Build dependencies; based on `base_clang`\n   - Language-specific variants: [`base_builder_go`](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-builder-go), etc.\n   - See [\u002Foss-fuzz\u002Finfra\u002Fbase-images\u002F](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images) for full list\n4. **Your project Docker image** - Project-specific dependencies; based on `base_builder` or language variant\n\n### Runner Images (Used Separately)\n\n- **[base_runner](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-runner)** - Executes harnesses; based on `base_clang`\n- **[base_runner_debug](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Finfra\u002Fbase-images\u002Fbase-runner-debug)** - With debug tools; based on `base_runner`\n\n## Advanced Usage\n\n### Tips and Tricks\n\n| Tip | Why It Helps |\n|-----|--------------|\n| **Don't manually copy source code** | Project Dockerfile likely already pulls latest version |\n| **Check existing projects** | Browse [oss-fuzz\u002Fprojects](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Ftree\u002Fmaster\u002Fprojects) for examples |\n| **Keep harnesses in separate repo** | Like [curl-fuzzer](https:\u002F\u002Fgithub.com\u002Fcurl\u002Fcurl-fuzzer) - cleaner organization |\n| **Use specific compiler versions** | Base images provide consistent build environment |\n| **Install dependencies in Dockerfile** | May require approval for OSS-Fuzz enrollment |\n\n### Criticality Score\n\nOSS-Fuzz uses a [criticality score](https:\u002F\u002Fgithub.com\u002Fossf\u002Fcriticality_score) to evaluate project acceptance. See [this example](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Fpull\u002F11444#issuecomment-1875907472) for how scoring works.\n\nProjects with lower scores may still be added to private OSS-Fuzz instances.\n\n### Hosting Your Own Instance\n\nSince OSS-Fuzz is open-source, you can host your own instance for:\n- Private projects not eligible for public OSS-Fuzz\n- Projects with lower criticality scores\n- Custom fuzzing infrastructure needs\n\n## Anti-Patterns\n\n| Anti-Pattern | Problem | Correct Approach |\n|--------------|---------|------------------|\n| **Manually pulling source in build.sh** | Doesn't use latest version | Let Dockerfile handle git clone |\n| **Copying code to OSS-Fuzz repo** | Hard to maintain, violates separation | Reference external harness repo |\n| **Ignoring base image versions** | Build inconsistencies | Use provided base images and compilers |\n| **Skipping local testing** | Wastes CI resources | Use helper.py locally before PR |\n| **Not checking build status** | Unnoticed build failures | Monitor build status page regularly |\n\n## Tool-Specific Guidance\n\n### libFuzzer\n\nOSS-Fuzz primarily uses libFuzzer as the fuzzing engine for C\u002FC++ projects.\n\n**Harness signature:**\n```c++\nextern \"C\" int LLVMFuzzerTestOneInput(const uint8_t *data, size_t size) {\n    \u002F\u002F Your fuzzing logic\n    return 0;\n}\n```\n\n**Build in build.sh:**\n```bash\n$CXX $CXXFLAGS -std=c++11 -I. \\\n    harness.cc -o $OUT\u002Fharness \\\n    $LIB_FUZZING_ENGINE .\u002Flibproject.a\n```\n\n**Integration tips:**\n- Use `$LIB_FUZZING_ENGINE` variable provided by OSS-Fuzz\n- Include `-fsanitize=fuzzer` is handled automatically\n- Link against static libraries when possible\n\n### AFL++\n\nOSS-Fuzz supports AFL++ as an alternative fuzzing engine.\n\n**Enable in project.yaml:**\n```yaml\nfuzzing_engines:\n  - afl\n  - libfuzzer\n```\n\n**Integration tips:**\n- AFL++ harnesses work alongside libFuzzer harnesses\n- Use persistent mode for better performance\n- OSS-Fuzz handles engine-specific compilation flags\n\n### Atheris (Python)\n\nFor Python projects with C extensions.\n\n**Example from [cbor2 integration](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Fpull\u002F11444):**\n\n**Harness:**\n```python\nimport atheris\nimport sys\nimport cbor2\n\n@atheris.instrument_func\ndef TestOneInput(data):\n    fdp = atheris.FuzzedDataProvider(data)\n    try:\n        cbor2.loads(data)\n    except (cbor2.CBORDecodeError, ValueError):\n        pass\n\ndef main():\n    atheris.Setup(sys.argv, TestOneInput)\n    atheris.Fuzz()\n\nif __name__ == \"__main__\":\n    main()\n```\n\n**Build in build.sh:**\n```bash\n# allow-legacy-python: build.sh runs inside the oss-fuzz container, where the shims are absent.\npip3 install .\nfor fuzzer in $(find $SRC -name 'fuzz_*.py'); do\n  compile_python_fuzzer $fuzzer\ndone\n```\n\n**Integration tips:**\n- Use `compile_python_fuzzer` helper provided by OSS-Fuzz\n- See [Continuously Fuzzing Python C Extensions](https:\u002F\u002Fblog.trailofbits.com\u002F2024\u002F02\u002F23\u002Fcontinuously-fuzzing-python-c-extensions\u002F) blog post\n\n### Rust Projects\n\n**Enable in project.yaml:**\n```yaml\nlanguage: rust\nfuzzing_engines:\n  - libfuzzer\nsanitizers:\n  - address  # Only AddressSanitizer supported for Rust\n```\n\n**Build in build.sh:**\n```bash\ncargo fuzz build -O --debug-assertions\ncp fuzz\u002Ftarget\u002Fx86_64-unknown-linux-gnu\u002Frelease\u002Ffuzz_target_1 $OUT\u002F\n```\n\n**Integration tips:**\n- [Rust supports only AddressSanitizer with libfuzzer](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002Fgetting-started\u002Fnew-project-guide\u002Frust-lang\u002F#projectyaml)\n- Use cargo-fuzz for local development\n- OSS-Fuzz handles Rust-specific compilation\n\n## Troubleshooting\n\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| **Build fails with missing dependencies** | Dependencies not in Dockerfile | Add `apt-get install` or equivalent in Dockerfile |\n| **Harness crashes immediately** | Missing input validation | Add size checks in harness |\n| **Coverage is 0%** | Harness not reaching target code | Verify harness actually calls target functions |\n| **Build timeout** | Complex build process | Optimize build.sh, consider parallel builds |\n| **Sanitizer errors in build** | Incompatible flags | Use flags provided by OSS-Fuzz environment variables |\n| **Cannot find source code** | Wrong working directory in Dockerfile | Set WORKDIR or use absolute paths |\n\n## Related Skills\n\n### Tools That Use This Technique\n\n| Skill | How It Applies |\n|-------|----------------|\n| **libfuzzer** | Primary fuzzing engine used by OSS-Fuzz |\n| **aflpp** | Alternative fuzzing engine supported by OSS-Fuzz |\n| **atheris** | Used for fuzzing Python projects in OSS-Fuzz |\n| **cargo-fuzz** | Used for Rust projects in OSS-Fuzz |\n\n### Related Techniques\n\n| Skill | Relationship |\n|-------|--------------|\n| **coverage-analysis** | OSS-Fuzz generates coverage reports via helper.py |\n| **address-sanitizer** | Default sanitizer for OSS-Fuzz projects |\n| **fuzz-harness-writing** | Essential for enrolling projects in OSS-Fuzz |\n| **corpus-management** | OSS-Fuzz maintains corpus for enrolled projects |\n\n## Resources\n\n### Key External Resources\n\n**[OSS-Fuzz Official Documentation](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002F)**\nComprehensive documentation covering enrollment, harness writing, and troubleshooting for the OSS-Fuzz platform.\n\n**[Getting Started Guide](https:\u002F\u002Fgoogle.github.io\u002Foss-fuzz\u002Fgetting-started\u002Faccepting-new-projects\u002F)**\nStep-by-step process for enrolling new projects into OSS-Fuzz, including requirements and approval process.\n\n**[cbor2 OSS-Fuzz Integration PR](https:\u002F\u002Fgithub.com\u002Fgoogle\u002Foss-fuzz\u002Fpull\u002F11444)**\nReal-world example of enrolling a Python project with C extensions into OSS-Fuzz. Shows:\n- Initial proposal and project introduction\n- Criticality score evaluation\n- Complete implementation (project.yaml, Dockerfile, build.sh, harnesses)\n\n**[Fuzz Introspector Case Studies](https:\u002F\u002Fgithub.com\u002Fossf\u002Ffuzz-introspector\u002Fblob\u002Fmain\u002Fdoc\u002FCaseStudies.md)**\nExamples and explanations of using Fuzz Introspector to analyze coverage and identify fuzzing blockers.\n\n### Video Resources\n\nCheck OSS-Fuzz documentation for workshop recordings and tutorials on enrollment and harness development.\n",{"name":5,"type":23,"description":7},"technique","main","321ccfe628eca0d314b0ee4eaffcdd8a05639aaf","plugins\u002Ftesting-handbook-skills\u002Fskills\u002Fossfuzz",0,"https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills","https:\u002F\u002Fgithub.com\u002Fbongkage","2026-11-06 12:15:06",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add bongkage\u002Ftrailofbits-skills --skill ossfuzz",{"tool":37,"command":38},"bunx","bunx skills add bongkage\u002Ftrailofbits-skills --skill ossfuzz",{"tool":40,"command":41},"pnpm","pnpm dlx skills add bongkage\u002Ftrailofbits-skills --skill ossfuzz","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Ftesting-handbook-skills\u002Fskills\u002Fossfuzz\u002FSKILL.md",true,[45,51],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",128,"https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Ftesting-handbook-skills\u002Fskills\u002Fossfuzz\u002Fagents\u002Fopenai.yaml",{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"assets\u002Ftrail-of-bits-mark.svg","ASSET","资产文件",3084,"https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Ftesting-handbook-skills\u002Fskills\u002Fossfuzz\u002Fassets\u002Ftrail-of-bits-mark.svg",[58,65,72,79,86,93],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M7CHJAESZRWKJXFQG55BMNAA","zeroize-audit","Detects missing zeroization of sensitive data in source code and identifies zeroization removed by compiler optimizations, with assembly-level analysis, and control-flow verification. Use for auditing C\u002FC++\u002FRust code handling secrets, keys, passwords, or other sensitive data.","https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fzeroize-audit\u002Fskills\u002Fzeroize-audit\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M7CHJ543G42A9GQC3PJE4F4V","yara-rule-authoring","Guides authoring of high-quality YARA-X detection rules for malware identification. Use when writing, reviewing, or optimizing YARA rules. Covers naming conventions, string selection, performance optimization, migration from legacy YARA, and false positive reduction. Triggers on: YARA, YARA-X, malware detection, threat hunting, IOC, signature, crx module, dex module.","https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fyara-authoring\u002Fskills\u002Fyara-rule-authoring\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M7CHHYVFS1AKDTH3YDS1Y4K4","writing-lean-proofs","Writes and reviews structured Lean 4 proofs and designs Lean libraries following Mathlib conventions. Use when proving theorems in Lean, formalizing mathematics or specifications in Lean 4, defining new types or definitions in a Lean library, reviewing Lean proofs for readability and maintainability, refactoring long tactic proofs into lemmas, filling in sorry placeholders in a Lean development, setting up CI or linters for a Lean project, diagnosing slow proofs or maxHeartbeats timeouts, or writing custom tactics, macros, or linters.","https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fwriting-lean-proofs\u002Fskills\u002Fwriting-lean-proofs\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7CHHQXA39M4965MV2RMM5YS","vulnerability-triage-brocards","This skill should be used when the user asks to \"triage a vulnerability report\", \"assess a CVE\", \"evaluate a bug bounty submission\", \"decide if a finding is valid\", \"review a security finding\", \"dismiss a vulnerability\", \"should we fix this CVE\", \"prioritize a vulnerability report\", or needs to determine whether an incoming vulnerability report warrants investigation. Applies 7 brocards (rules of thumb) to systematically accept, dismiss, or request more information on vulnerability reports, or needs to filter raw findings from agentic vulnerability discovery pipelines before human review.","https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fvulnerability-triage-brocards\u002Fskills\u002Fvulnerability-triage-brocards\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":18},"01M7CHHJVQC2ZG2M310GXT0T42","variant-analysis","Hunts for the other instances of a bug already found — the variants of one root cause across a codebase. Use immediately after a vulnerability, logic bug, or bad pattern turns up in a specific file and the question becomes where else it occurs, including the bare conversational form (\"are there others like this?\", \"is this the same bug?\"). Also for generalizing one known instance into a CodeQL or Semgrep query for its whole pattern family, and for triaging a set of look-alike candidates against a known root cause. Not for initial discovery with no bug in hand.","https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fvariant-analysis\u002Fskills\u002Fvariant-analysis\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":18},"01M7CHHC1GM5GH585ZWGP7D03P","vector-forge","Mutation-driven test vector generation. Finds implementations of a cryptographic algorithm or protocol, runs mutation testing to identify escaped mutants, then generates new test vectors that deliberately exercise the uncovered code paths. Compares before\u002Fafter mutation kill rates to prove vector effectiveness. Use when generating cryptographic test vectors, measuring Wycheproof coverage gaps, finding escaped mutants via mutation testing, creating cross-implementation test suites, or improving test vector coverage for crypto primitives.","https:\u002F\u002Fgithub.com\u002Fbongkage\u002Ftrailofbits-skills\u002Fblob\u002Fmain\u002Fplugins\u002Ftrailmark\u002Fskills\u002Fvector-forge\u002FSKILL.md",[],[]]