← Back to Skills Marketplace
828
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install pcap-analyzer
Description
Analyze local PCAP/PCAPNG files with tshark to generate detailed network forensics reports including talkers, ports, DNS, TLS, HTTP, and anomaly summaries.
Usage Guidance
This skill mostly does what it says (local tshark-based PCAP summarization), but it has a notable misconfiguration: skill.yaml and SKILL.md prefer/require /home/tom/openclaw-tools/pcap_summary.sh — a hard-coded, user-specific path outside the skill. That means if that file exists on your system it will be executed instead of the bundled script, and you should not assume it behaves safely. Before installing or running: (1) inspect /home/tom/openclaw-tools/pcap_summary.sh if it exists on your machine and ensure you trust it; (2) prefer running the bundled scripts/analyze.sh manually to confirm behavior; (3) ensure tshark (and awk/sed) are installed and run tests on non-sensitive PCAPs first; (4) ask the publisher to fix skill.yaml to call the bundled script (not a hard-coded home path) and to declare required binaries; (5) avoid running as root and avoid providing PCAPs that contain secrets until you’ve verified the tool’s behavior. The inconsistencies could be an innocent packaging error — but treat it as suspicious until corrected.
Capability Analysis
Type: OpenClaw Skill
Name: pcap-analyzer
Version: 0.1.0
The skill is classified as suspicious due to its critical reliance on an external, unprovided script located at a hardcoded path (`/home/tom/openclaw-tools/pcap_summary.sh`). This dependency is explicitly stated in `SKILL.md` (as a required file), `scripts/analyze.sh` (as the preferred execution path), and `skill.yaml` (as the primary command). The actual behavior of the skill is unknown and entirely dependent on this external script, posing a significant supply chain risk and potential for arbitrary code execution if the external script is malicious or vulnerable to input injection.
Capability Assessment
Purpose & Capability
The skill claims local PCAP analysis with tshark, which matches the included scripts. However SKILL.md metadata and skill.yaml reference /home/tom/openclaw-tools/pcap_summary.sh (an external user-specific path) while the bundle actually contains scripts/analyze.sh. The registry metadata lists no required binaries, but SKILL.md lists tshark, awk, sed — a mismatch. The hard-coded external path is not justified by the stated purpose and is unexpected for a portable skill.
Instruction Scope
scripts/analyze.sh operates locally and only reads the user-provided PCAP, which is coherent. But skill.yaml's command runs /home/tom/openclaw-tools/pcap_summary.sh directly (outside the skill bundle). SKILL.md also lists that external file as a preferred summarizer. That gives the skill the capability to execute arbitrary code outside the shipped files if that external script exists; SKILL.md's claim 'does not exfiltrate the PCAP' is plausible for the included script but cannot be guaranteed for the external /home/tom script.
Install Mechanism
There is no install spec; this is instruction-only plus a small helper script in the bundle. No downloads or extraction are requested, which is low risk for installation. The only risk is runtime execution of an external path if present.
Credentials
The skill declares no required environment variables or credentials, which is appropriate. However SKILL.md metadata requires external files at /home/tom/openclaw-tools/pcap_summary.sh — effectively a config path requirement not declared in the registry. That path could reference an unexpected script and grants the skill ability to run code outside the bundle; this is disproportionate to a portable PCAP analyzer.
Persistence & Privilege
The skill does not request persistent/always-enabled privileges (always: false) and does not attempt to modify other skills or system-wide settings. Default autonomous invocation is allowed (platform default) but does not combine with other escalated privileges here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pcap-analyzer - After installation, invoke the skill by name or use
/pcap-analyzer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of pcap-analyzer: A local PCAP/PCAPNG network-forensics summarizer using tshark.
- Generates structured reports: talkers, conversations, ports, DNS, TLS, HTTP, and anomalies.
- Requires tshark, awk, sed, and a local analysis script (pcap_summary.sh).
- Designed for lab work, incident triage, and CPENT-style exercises.
- No exfiltration of PCAPs; operates fully on the local machine.
- Optional input: focus on specific IP addresses or time windows.
Metadata
Frequently Asked Questions
What is PCAP Analyzer?
Analyze local PCAP/PCAPNG files with tshark to generate detailed network forensics reports including talkers, ports, DNS, TLS, HTTP, and anomaly summaries. It is an AI Agent Skill for Claude Code / OpenClaw, with 828 downloads so far.
How do I install PCAP Analyzer?
Run "/install pcap-analyzer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is PCAP Analyzer free?
Yes, PCAP Analyzer is completely free (open-source). You can download, install and use it at no cost.
Which platforms does PCAP Analyzer support?
PCAP Analyzer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created PCAP Analyzer?
It is built and maintained by marposins (@marposins); the current version is v0.1.0.
More Skills