← Back to Skills Marketplace
newageinvestments25-byte

Isp Throttle Detective

by New Age Investments · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
122
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install isp-throttle-detective
Description
Run speed tests to multiple endpoints, log results, and detect ISP throttling patterns. Use when the user mentions speed test, internet slow, ISP throttling,...
README (SKILL.md)

ISP Throttle Detective

Scripts live in scripts/. Log and config default to ~/.isp-throttle-detective/. See references/setup-guide.md for full setup, scheduling, and interpretation guidance.

Workflow

Run a single test and log it

python3 scripts/speedtest.py | python3 scripts/log_result.py

Analyze patterns (needs ≥5 tests across multiple hours/days)

python3 scripts/analyze.py
python3 scripts/analyze.py --days 30 --json   # machine-readable

Generate evidence report

python3 scripts/report.py --days 30 --out ~/report.md

Scripts

Script Purpose
speedtest.py Download from 3 endpoints + upload to Cloudflare. Outputs JSON to stdout.
log_result.py Append speedtest JSON to JSONL log with hour, day_of_week enrichment.
analyze.py Detect peak vs off-peak, CDN discrimination, trend, anomalies.
report.py Generate markdown evidence report with tables and plain-English conclusion.

Configuration

Copy assets/config.example.json to ~/.isp-throttle-detective/config.json. All scripts auto-detect it. Key fields:

  • log_file — where the JSONL log lives
  • endpoints — add/remove test targets; set category: "cdn" vs "general" to enable CDN discrimination detection
  • peak_hours — list of hours (0–23) considered peak

Pass --config /path/to/config.json to any script to override.

Scheduling

See references/setup-guide.md for launchd (macOS) and cron (Linux) snippets. Recommended: every 30 minutes for meaningful data within a day or two.

Throttling Signals

  • Peak-hour drop >20% vs off-peak → time-based throttling
  • CDN speed \x3C75% of general internet → destination-based throttling
  • Declining trend slope → infrastructure degradation
  • Multiple low-speed anomalies at the same hour → systematic, not random

Using the Evidence Report

report.py produces a markdown file with a peak/off-peak comparison table, per-endpoint breakdown, hourly chart, trend analysis, and a plain-English conclusion. Share it directly with ISP support or use it to evaluate whether upgrading your plan would actually help (if CDN throttling is confirmed, a faster plan won't fix it).

Usage Guidance
This skill appears to do what it claims. Before installing or scheduling it: (1) be aware tests download up to ~25 MB and upload ~5 MB per run by default — running every 30 minutes can consume significant data on metered connections; reduce max_download_bytes or schedule less frequently if needed; (2) logs and reports are stored under ~/.isp-throttle-detective and include timestamps and test metadata — treat them as local telemetry you may share with an ISP; (3) review and, if desired, customize the endpoints in the config (the example includes a CloudFront URL that may download a large ZIP); (4) curl is optionally invoked if present — that subprocess usage is for measurement accuracy and not executing fetched content; (5) no credentials or hidden network exfiltration were found. If you want higher assurance, inspect the packaged scripts locally or run them in a sandboxed/network-metered environment first.
Capability Analysis
Type: OpenClaw Skill Name: isp-throttle-detective Version: 1.0.0 The isp-throttle-detective skill bundle is a legitimate tool designed to monitor internet performance and identify ISP throttling. It consists of Python scripts (speedtest.py, analyze.py, log_result.py, report.py) that measure download/upload speeds from reputable endpoints like Cloudflare and GitHub, log the data locally in ~/.isp-throttle-detective/, and generate statistical reports. The use of subprocess to call curl and internal scripts is handled safely without shell=True, and there is no evidence of data exfiltration, malicious persistence, or prompt injection.
Capability Assessment
✓ Purpose & Capability
Name/description describe speed testing and throttling analysis; code implements downloads/uploads to public endpoints, logging, analysis, and report generation. Required resources (no env vars, writes to a home config/log path) are proportionate to the stated task.
ℹ Instruction Scope
SKILL.md and scripts instruct the agent to run local Python scripts that read/write config and logs under ~/.isp-throttle-detective and perform network requests to listed public endpoints (Cloudflare, npm registry, GitHub, optionally CloudFront). This is expected, but the scripts will perform repeated large downloads/uploads (default cap 25 MB per test, upload 5 MB) and create persistent logs — users should be aware of bandwidth, metered connections, and privacy of stored timestamps and test metadata.
✓ Install Mechanism
Instruction-only skill with bundled Python scripts; no install spec or external archives are fetched by an installer. The code uses subprocess to call curl if available and to run local analysis; this is normal for accuracy and report generation.
✓ Credentials
No environment variables, credentials, or config paths for unrelated services are requested. The scripts read a config file under the user's home directory (expected) and write logs there. No secrets are required or accessed.
✓ Persistence & Privilege
Skill is not always-enabled and does not request permanent platform presence. It writes its own config and logs under ~/.isp-throttle-detective, which is appropriate for its function and within its declared scope.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install isp-throttle-detective
  3. After installation, invoke the skill by name or use /isp-throttle-detective
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Multi-endpoint speed testing with ISP throttling detection. Peak vs off-peak analysis, CDN discrimination reports, evidence generation.
Metadata
Slug isp-throttle-detective
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Isp Throttle Detective?

Run speed tests to multiple endpoints, log results, and detect ISP throttling patterns. Use when the user mentions speed test, internet slow, ISP throttling,... It is an AI Agent Skill for Claude Code / OpenClaw, with 122 downloads so far.

How do I install Isp Throttle Detective?

Run "/install isp-throttle-detective" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Isp Throttle Detective free?

Yes, Isp Throttle Detective is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Isp Throttle Detective support?

Isp Throttle Detective is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Isp Throttle Detective?

It is built and maintained by New Age Investments (@newageinvestments25-byte); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments