offensive-tools/recon/eyewitness/SKILL.md
Web screenshotting and reporting tool that captures screenshots of web services and generates an HTML report. Use when asked to visually enumerate web services, screenshot a list of URLs/hosts, generate visual web inventory, or create a report of discovered web interfaces.
npx skillsauth add aeondave/malskill eyewitnessInstall 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.
Screenshots web services and produces an HTML report with categorized results.
# Screenshot from URL list
eyewitness -f urls.txt --web
# Screenshot from nmap XML
eyewitness -x nmap_scan.xml --web
# Specify output directory
eyewitness -f urls.txt --web -d output/eyewitness
| Flag | Description |
|------|-------------|
| -f <file> | Input file with URLs/hosts |
| -x <xml> | Nmap XML output file |
| --web | HTTP screenshotting (default) |
| --rdp | RDP screenshots |
| --vnc | VNC screenshots |
| -d <dir> | Output directory |
| --no-prompt | Skip interactive prompts |
| --timeout <n> | Per-target timeout (default 7s) |
| --threads <n> | Threads (default 10) |
| --delay <n> | Delay between requests |
| --proxy-ip <ip> | Proxy IP |
| --proxy-port <port> | Proxy port |
| --resolve | Resolve IP addresses |
| --add-http-headers <h> | Add custom headers |
| --user-agent <ua> | Custom user agent |
| --prepend-https | Prepend https:// to input |
| --prepend-http | Prepend http:// to input |
| --active-scan | Active fingerprinting |
| --jitter <n> | Jitter between screenshots |
# Screenshot a subdomain list
cat subs.txt | sed 's/^/http:\/\//' > urls.txt
eyewitness -f urls.txt --web -d report/ --no-prompt
# From nmap scan + report
nmap -sV -p 80,443,8080,8443 -oX scan.xml 192.168.1.0/24
eyewitness -x scan.xml --web -d web_report/ --no-prompt
# With both HTTP and HTTPS
eyewitness -f hosts.txt --prepend-http --prepend-https --web -d out/
# RDP screenshot of internal network
eyewitness -f hosts.txt --rdp -d rdp_report/
EyeWitness produces:
report.html — categorized screenshots with HTTP headers, page titles, response codesMatches/ — signature-based categories (login pages, Cisco, Citrix, VMware, etc.)Screenshots/ — raw screenshot images (PNG)Eyewitness.db — SQLite database with all results# From subfinder → httpx → eyewitness
subfinder -d target.com -silent | \
httpx -silent | \
tee live_hosts.txt | \
eyewitness --web -f /dev/stdin -d eyewitness_out/ --no-prompt
# From masscan/nmap port scan
masscan -p 80,443,8080,8443,8000,8888 192.168.1.0/24 -oX masscan.xml
eyewitness -x masscan.xml --web -d report/ --no-prompt
# Include non-standard ports (use httpx first)
cat hosts.txt | httpx -ports 80,443,8080,8443,3000,5000,8888 -silent | \
eyewitness --web -f /dev/stdin -d report/ --no-prompt
| File | When to load |
|------|--------------|
| references/report-tips.md | HTML report layout, signature categories, pipeline integration, DB queries |
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.