offensive-tools/cloud/trufflehog/SKILL.md
Find leaked credentials and secrets in git repos, S3 buckets, filesystems, and CI systems using entropy analysis and 700+ detectors. Use when hunting for secrets in large codebases or cloud storage during recon.
npx skillsauth add aeondave/malskill trufflehogInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Secret scanner with 700+ detectors — git history, S3, GCS, filesystem, and CI systems.
# Docker
docker run --rm trufflesecurity/trufflehog:latest git https://github.com/org/repo
# Binary
trufflehog git https://github.com/org/repo --only-verified
# Local repo
trufflehog git file:///path/to/repo --only-verified
# S3 bucket
trufflehog s3 --bucket=target-bucket
| Flag | Purpose |
|------|---------|
| git <url> | Scan git repo |
| s3 | Scan S3 bucket |
| filesystem | Scan local files |
| --only-verified | Show only verified secrets |
| --since-commit SHA | Scan from commit |
| --branch NAME | Scan specific branch |
| --json | JSON output |
| --concurrency N | Thread count |
| --include-detectors | Limit detector types |
Verified secrets only (CI-safe):
trufflehog git https://github.com/org/repo --only-verified --json > secrets.json
Full history of internal monorepo:
trufflehog git file:///repos/monorepo --json --concurrency 8
S3 audit:
trufflehog s3 --bucket internal-assets --only-verified
| File | When to load |
|------|--------------|
| references/ | Detector list and custom detector config |
development
Auth/lab ref: Unicorn Engine CPU-only emulation for shellcode, decryptors, custom VM handlers, instruction tracing, memory hooks, and register-level experiments.
development
Auth/lab ref: Renode board and SoC simulation for MCU/RTOS firmware, UART/GPIO/peripheral modeling, GDB remote debugging, REPL platforms, and RESC scripts.
development
Auth/lab ref: Qiling OS-layer binary emulation for PE/ELF/Mach-O/UEFI/shellcode with rootfs, syscall/API hooks, filesystem mapping, and runtime patching.
databases
Auth/lab ref: QEMU user-mode and full-system emulation for cross-arch binaries, firmware, kernels, disks, serial consoles, networking, and GDB stubs.