← Back to Skills Marketplace
Net Detective
by
New Age Investments
· GitHub ↗
· v1.0.0
· MIT-0
106
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install nai-net-detective
Description
Run detailed network diagnostics including DNS resolution, traceroute, MTU, and speed tests, then provide a clear plain-English report explaining any issues...
Usage Guidance
What to consider before installing:
- Functionally the package appears to do what it claims: run ping/traceroute/MTU/DNS checks and optional speed downloads and produce a human-readable report. Expect the scripts to call system binaries: ping, traceroute, ip/route, and curl. If those are missing the scripts will report errors.
- Network traffic: the tool sends DNS queries to 8.8.8.8 and 1.1.1.1 (and uses your system resolver) and downloads test payloads from Cloudflare's speed endpoint. That is expected for a speed/DNS tester, but be aware it contacts external servers.
- Local persistence: results are recorded to a hardcoded history file (~/.openclaw/workspace/skills/net-detective/data/history.json). Review or back up that file if you care about privacy; the skill does not request credentials but it will store timestamps and network metrics locally.
- Metadata mismatch: the registry metadata states "no required binaries / no config paths", which is misleading because the scripts assume system binaries and write to a history path. Treat that as sloppy packaging rather than an immediate red flag, but validate presence/permissions of the referenced binaries and the writable history path before running.
- Code quality: there are signs of incomplete code/truncation in the provided diagnose.py (a truncated/incorrect return near run_speed) which may cause runtime errors. I recommend reviewing/ testing the scripts locally (or running them in an isolated/test environment) before relying on them for critical troubleshooting.
- If you plan to share diagnostic output with others, inspect the saved JSON in the history path to ensure you are not exposing local hostnames/IPs you prefer to keep private.
If you want, I can: (a) point out the exact lines where the metadata mismatches occur; (b) highlight the truncated/buggy portion in diagnose.py and suggest a fix; or (c) produce a safe, read-only dry-run checklist to run before executing these scripts on your machine.
Capability Analysis
Type: OpenClaw Skill
Name: nai-net-detective
Version: 1.0.0
The 'net-detective' skill bundle is a well-structured network diagnostic tool that performs DNS checks, ping tests, traceroute, MTU detection, and speed tests. All scripts (diagnose.py, dns_check.py, speedtest.py, etc.) use the Python standard library and standard system utilities like ping and curl in a safe manner (using subprocess lists to avoid shell injection). The data collected (local IP, gateway, and performance metrics) is strictly relevant to its stated purpose, and there is no evidence of data exfiltration, obfuscation, or malicious intent.
Capability Assessment
Purpose & Capability
The name/description (network diagnostics) matches the included scripts: DNS checks, traceroute, MTU, and speed tests. However the package metadata claims "required binaries: none" and "required config paths: none" while the scripts call system binaries (ping, traceroute, ip/route, curl) and expect to read/write a history file under the user's home. That metadata mismatch is misleading and could cause surprise at runtime.
Instruction Scope
Runtime instructions only tell the agent to run the bundled scripts, which is consistent with the purpose. The scripts perform active network traffic to third-party servers (Google/Cloudflare DNS servers and Cloudflare's speed endpoint) and will write/append history to a file in the user's home directory (~/.openclaw/workspace/skills/net-detective/data/history.json). This behavior is expected for a network diagnostic tool but is worth calling out: data is sent externally and local state is persisted.
Install Mechanism
There is no install spec (instruction-only at install time). The repository includes runnable Python scripts (no third‑party packages). Lack of an install step is low risk, but because code files are included the runtime will execute local scripts that invoke system binaries — nothing is downloaded from remote URLs during install.
Credentials
The skill requests no credentials or environment variables, which is appropriate. Minor concerns: history.py hardcodes a HISTORY_FILE under the user's home (~/.openclaw/...), which the registry metadata did not declare as a required config path. The scripts also assume presence of system tools (ping, traceroute, curl, ip/route) but do not declare them in metadata.
Persistence & Privilege
The skill is not always-enabled and does not request elevated OS privileges, but it does persist diagnostic results to a file in the user's home directory. That creates a local footprint (diagnostics over time) but does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nai-net-detective - After installation, invoke the skill by name or use
/nai-net-detective - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Net Detective: a structured network diagnostics tool.
- Supports DNS checks (Google, Cloudflare, system), traceroute, MTU detection, and speed tests with no external dependencies.
- Adds automated result comparison against historical baselines for anomaly detection.
- Generates plain-English diagnostic reports suitable for non-technical users.
- Modular scripts (diagnose, dns_check, speedtest, history, report) for flexible workflows.
- Cross-platform (macOS and Linux); Python standard library only.
Metadata
Frequently Asked Questions
What is Net Detective?
Run detailed network diagnostics including DNS resolution, traceroute, MTU, and speed tests, then provide a clear plain-English report explaining any issues... It is an AI Agent Skill for Claude Code / OpenClaw, with 106 downloads so far.
How do I install Net Detective?
Run "/install nai-net-detective" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Net Detective free?
Yes, Net Detective is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Net Detective support?
Net Detective is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Net Detective?
It is built and maintained by New Age Investments (@newageinvestments25-byte); the current version is v1.0.0.
More Skills