The Complete Production SOP: How to Deploy and Run Wireshark & tshark Packet Capture Traffic Analysis in Autonomous AI Agents

---
name: "wireshark-pcap-traffic-analyzer"
description: "Analyze network protocols, decrypt TLS streams, and detect anomalies with Wireshark/tshark."
metadata:
  author: "Wireshark Foundation"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "analyze pcap with tshark"
  - "decrypt tls in wireshark"
  - "filter dns traffic tshark"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Wireshark & tshark Packet Capture Traffic Analysis

Inspects packet captures (.pcap) using Wireshark and tshark CLI: display filters, TCP stream reassembly, TLS session key decryption with SSLKEYLOGFILE, and HTTP/DNS traffic auditing.

## When to Invoke
Invoke this skill whenever you need to:
- analyze pcap with tshark
- decrypt tls in wireshark
- filter dns traffic tshark

## Execution SOP & Rules
1. Filter captures using tshark display filters: tshark -r capture.pcap -Y 'http.request or dns'.
2. Extract specific fields with -T fields -e ip.src -e ip.dst -e http.request.uri.
3. Decrypt TLS traffic by setting Pre-Master-Secret log filename in Wireshark preferences.
4. Identify anomalous connection spikes and abnormal retransmission rates.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.

#!/usr/bin/env bash
set -euo pipefail

if ! command -v tshark &> /dev/null; then
  echo "ERROR: tshark is not installed. Install via apt-get or brew." >&2
  exit 1
fi

echo "tshark detected: $(tshark -v | head -n 1)"
if [ -f "./captures/traffic.pcap" ]; then
  echo "Target capture found: $(du -h ./captures/traffic.pcap | cut -f1)"
fi

tshark -r ./captures/traffic.pcap \
  -Y "http.request or dns" \
  -T fields \
  -e frame.number -e ip.src -e ip.dst -e dns.qry.name -e http.host -e http.request.uri \
  -E header=y -E separator=/t | head -n 30

#!/usr/bin/env bash
set -euo pipefail

if [ ! -s ./reports/dns_audit.json ]; then
  echo "Audit artifact empty or missing." >&2
  exit 1
fi

jq . ./reports/dns_audit.json > /dev/null
echo "Audit verification complete. Valid JSON generated."