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 |
data-ai
Scoped routing: Linux operator; hosts, sessions, users, services, packages, logs, containers, SSH, network paths, privilege evidence.
development
Offensive methodology for ICS/OT/SCADA environments in authorized industrial penetration testing and red team operations. Use when assessing PLCs, RTUs, HMIs, engineering workstations, historians, or field devices running Modbus, DNP3, EtherNet/IP, S7comm/S7+, Profinet, IEC 60870-5-104, BACnet, or OPC-UA. Covers passive OT network enumeration, protocol-level device interrogation, PLC coil/register read-write attacks, HMI session exploitation, historian and engineering workstation compromise, and safe escalation rules for critical infrastructure scope. Does not cover: general IT network exploitation (network-technique), physical hardware interfaces UART/JTAG/SPI (hardware-technique), wireless sensor network attacks (wireless-technique), RF/SDR signal analysis (hardware-ctf or wireless-technique), or CTF-framed ICS lab tasks (ics-ctf).
tools
Offensive methodology for authorized game security assessments, game client security research, and game-adjacent penetration testing in real-world engagements. Use when assessing game clients for cheating vulnerabilities, testing anti-cheat effectiveness, auditing game server protocols for score manipulation or economic fraud, reverse engineering game DRM or license validation, analyzing game save file protection, or assessing game mod/plugin security. Covers: process memory scanning and manipulation (Cheat Engine methodology), game binary reversing for license and DRM bypass, game network protocol analysis and packet replay, anti-cheat mechanism analysis, save file format reversing and tampering, speed hack and value injection techniques. Does NOT cover: CTF game challenges (game-ctf), game engine source code auditing (web-exploit-technique or vuln-search-technique for the backend), or general binary exploitation (pwn-ctf or reversing-technique).
development
Auth assessment: hardware/embedded methodology; UART/JTAG/SWD/SPI/I2C, firmware extraction, boot/debug paths, embedded OS evidence.