Skip to content

hypnguyen1209/offensive-claude / skills/wireless-rf

wireless-rf

Verified

Use when the target has a non-Wi-Fi radio attack surface — Bluetooth/BLE (GATT, pairing, KNOB/BIAS/BleedingTooth), Zigbee/Thread/Matter & Z-Wave mesh (Touchlink, S0 downgrade), LoRaWAN/Sub-GHz LPWAN, SDR capture/replay/rolljam, smart locks/medical/IoT radios. For Wi-Fi/WPA/evil-twin see network-attack.

FileKindSize
SKILL.mdskill md8.7 KB
references/bluetooth.mdmarkdown6.8 KB
references/lpwan-subghz.mdmarkdown5.8 KB
references/mesh-iot-radio.mdmarkdown5.6 KB
scripts/rf_recon.shscript4.2 KB

scripts/rf_recon.sh

View on GitHub
#!/usr/bin/env bash
# rf_recon.sh - non-Wi-Fi RF reconnaissance/enumeration driver: BLE discovery + GATT enumeration,
# Zigbee/802.15.4 network discovery, and Sub-GHz/ISM signal fingerprinting.
#
# SCOPE: recon/enumeration ONLY. This script does not transmit attack frames, jam, replay, or write to
#   devices by default. The one action that touches a peripheral (ble-enum) performs read-only GATT
#   discovery + read of a handle you pass explicitly. Actual exploitation (crackle, zbreplay, RollJam,
#   URH replay) is deliberately left to the operator per-technique, under written authorization, because
#   it has physical impact. See references/*.md.
#
# USAGE:
#   ./rf_recon.sh ble-scan                         # discover BLE advertisers
#   ./rf_recon.sh ble-enum   <BD_ADDR> [handle]    # GATT services/characteristics (+ optional read)
#   ./rf_recon.sh zb-scan                          # discover Zigbee/802.15.4 networks (KillerBee)
#   ./rf_recon.sh subghz-id  [freq]                # fingerprint an ISM signal (rtl_433 analyze)
#
# DEPENDENCIES (install per technique; the script checks and tells you what is missing):
#   BLE:     bluez (bluetoothctl/hcitool/gatttool) and/or bettercap
#   Zigbee:  killerbee (zbstumbler) + a supported 802.15.4 radio (RZUSBstick/ApiMote)
#   Sub-GHz: rtl_433 + an RTL-SDR (or HackRF)
#
# OPSEC / LEGAL: RF crosses walls and property lines. Confirm the target device/band is IN SCOPE and that
#   you have written authorization BEFORE running anything here. Even passive capture of others' traffic
#   may be regulated in your jurisdiction. Transmitting/jamming without authorization is illegal.

set -euo pipefail

MODE="${1:-}"; shift || true

_need() {
    # _need <binary> <hint> ; returns non-zero (and warns) if the tool is absent
    if ! command -v "$1" >/dev/null 2>&1; then
        echo "[!] missing '$1' - install it ($2) and re-run" >&2
        return 1
    fi
}

_authz_banner() {
    echo "=============================================================================="
    echo " rf_recon.sh - AUTHORIZED RF assessment only. Confirm the target/band is in"
    echo " scope (scope.json) and you have written authorization. RF reaches neighbours."
    echo "=============================================================================="
}

ble_scan() {
    _authz_banner
    if command -v bettercap >/dev/null 2>&1; then
        echo "[*] BLE recon via bettercap (20s)..."
        sudo bettercap -eval "ble.recon on; sleep 20; ble.show; ble.recon off; q"
    elif _need hcitool "apt install bluez"; then
        echo "[*] BLE scan via hcitool (Ctrl-C to stop)..."
        sudo hcitool lescan --duplicates
    else
        return 1
    fi
}

ble_enum() {
    local ADDR="${1:?BD_ADDR required (see ble-scan output)}"
    local HANDLE="${2:-}"
    _authz_banner
    _need gatttool "apt install bluez" || return 1
    echo "[*] Primary services on $ADDR:"
    gatttool -b "$ADDR" --primary || true
    echo "[*] Characteristics (note the 'props' - Write/WriteWithoutResponse without pairing = candidate):"
    gatttool -b "$ADDR" --characteristics || true
    if [ -n "$HANDLE" ]; then
        echo "[*] Reading handle $HANDLE (read-only):"
        gatttool -b "$ADDR" --char-read -a "$HANDLE" || true
    fi
    echo "[i] To test an unauthenticated write (impact proof), do it explicitly & in scope:"
    echo "    gatttool -b $ADDR --char-write-req -a <handle> -n <hexvalue>"
}

zb_scan() {
    _authz_banner
    _need zbstumbler "pip install killerbee (+ a supported 802.15.4 radio)" || return 1
    echo "[*] Zigbee/802.15.4 discovery across channels 11-26..."
    sudo zbstumbler
}

subghz_id() {
    local FREQ="${1:-}"
    _authz_banner
    _need rtl_433 "apt install rtl-433 (+ an RTL-SDR)" || return 1
    if [ -n "$FREQ" ]; then
        echo "[*] Decoding known ISM device protocols at $FREQ (JSON)..."
        rtl_433 -F json -f "$FREQ"
    else
        echo "[*] Auto-analyzing modulation/timing of an unknown ISM signal (rtl_433 -A)..."
        rtl_433 -A
    fi
}

case "$MODE" in
    ble-scan)   ble_scan ;;
    ble-enum)   ble_enum "$@" ;;
    zb-scan)    zb_scan ;;
    subghz-id)  subghz_id "$@" ;;
    *)
        echo "usage: $0 {ble-scan|ble-enum <BD_ADDR> [handle]|zb-scan|subghz-id [freq]}" >&2
        exit 2
        ;;
esac
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall