optimize-network
This skill runs evidence-first network diagnostics and optimization on macOS, starting with read-only measurements of speed, latency, jitter, and DNS performance. It protects VPN and proxy services by default, proposing only reversible changes like DNS A/B tests, service reordering, or AWDL toggling before applying them. Use it to identify bottlenecks in link quality, bufferbloat, DNS instability, or background traffic, then verify improvements with before-and-after measurements.
Optimize Network safely diagnoses and improves local network speed, latency, and stability while protecting VPN and proxy tools.
AI-generated summary based on this skill's SKILL.md
Install
majiayu000/spellbook/optimize-network · repository language: Python
git clone https://github.com/majiayu000/spellbook
cp -r spellbook/skills/optimize-network ~/.claude/skills/optimize-networknpx skillfed install majiayu000/spellbook/optimize-networkFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How does optimize-network diagnose slow internet speed?
optimize-network starts with read-only measurements of speed, latency, jitter, and DNS performance to establish a baseline. It then identifies bottlenecks in link quality, bufferbloat, DNS instability, or background traffic using evidence-first methodology. Once root causes are pinpointed, the skill proposes reversible changes—such as DNS A/B tests, service reordering, or AWDL toggling—before applying them, so you can verify improvements with before-and-after measurements.
Can optimize-network fix bufferbloat on my Mac safely?
Yes. optimize-network protects VPN and proxy services by default and only proposes reversible network experiments. To address bufferbloat, it may suggest toggling AWDL, reordering network services, or adjusting DNS settings—all changes you can roll back. The skill generates diagnostic reports with rollback recommendations so you can safely test each optimization and confirm it improves responsiveness without breaking your VPN or proxy.
What does optimize-network do to improve network responsiveness?
optimize-network runs reversible network experiments with before-and-after verification to improve responsiveness. It diagnoses latency, jitter, and packet loss across Wi-Fi and Ethernet, then proposes safe changes like DNS optimization, service reordering, or AWDL toggling. Each experiment is designed to be rolled back, so you can test improvements incrementally and confirm that network quality actually increases without destabilizing your connectivity or VPN.
How does optimize-network protect my VPN while optimizing?
optimize-network safeguards VPN and proxy services by default—it never proposes changes that would break them. The skill uses evidence-first diagnostics to identify bottlenecks without touching VPN configurations, and any reversible experiments it suggests (DNS tests, service reordering, AWDL toggling) are designed to coexist safely with active VPN or proxy. Before-and-after measurements confirm that optimizations maintain your secure connectivity.
What network metrics does optimize-network measure and report?
optimize-network measures speed, latency, jitter, packet loss, DNS performance, and bufferbloat. It generates diagnostic reports that show baseline readings, identifies bottlenecks, and recommends reversible changes with rollback instructions. The skill's evidence-first approach means every recommendation is backed by actual measurements, so you can see exactly which metrics improved and decide whether to keep or undo each optimization.
Is optimize-network safe to use on macOS without breaking services?
Yes. optimize-network is designed for safety: it starts with read-only diagnostics, proposes only reversible changes, and protects VPN and proxy by default. All experiments—DNS A/B tests, service reordering, AWDL toggling—can be rolled back. The skill verifies improvements with before-and-after measurements, so you retain full control and can undo any change that doesn't help or causes issues.
SKILL.md
rendered from the published skill — quoted content, verbatim
Optimize Network
Use this skill to run a safe, evidence-first network optimization workflow. The default posture is read-only diagnosis, then small reversible experiments, then before/after verification. Never treat VPN, proxy, TUN, or routing tools as junk processes.
Safety Contract
Follow these rules before any command that could affect connectivity:
- Intent lock: the goal is speed, latency, responsiveness, and stability, not cleaning network
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 3 files
skills/optimize-network/SKILL.md
skills/optimize-network/evals/evals.json
skills/optimize-network/scripts/macos_network_snapshot.sh