Network Optimizer Skill

Safe cross-platform network diagnostics and reversible network tuning as an Agent Skill.

Release v0.2.0 · Launch discussion · Promotion kit

The skill turns a network-tuning request into a repeatable workflow:

• Run a before baseline first.
• Separate real WAN/LAN problems from local proxy, VPN, tunnel, or DNS effects.
• Check Wi-Fi/Ethernet quality, DNS latency, MTU, packet loss, service priority, route selection, and background traffic.
• Support macOS, Linux, and Windows diagnostics.
• Support Linux BBR and BBR+FQ tuning with compatibility checks, backups, and explicit approval.
• Run an after baseline and compare results before claiming improvement.

This repository includes a Codex plugin manifest at .codex-plugin/plugin.json and a Codex marketplace at .agents/plugins/marketplace.json.

codex plugin marketplace add 6Kmfi6HP/network-optimizer-skill
codex plugin add network-optimizer-skill@network-optimizer-skill

You can also install it interactively from the Network Optimizer Skill marketplace tab in /plugins.

This repository includes a Claude Code plugin manifest at .claude-plugin/plugin.json and a Claude marketplace at .claude-plugin/marketplace.json.

Inside Claude Code:

/plugin marketplace add 6Kmfi6HP/network-optimizer-skill
/plugin install network-optimizer-skill@network-optimizer-skill
/reload-plugins

For local development:

claude --plugin-dir ./network-optimizer-skill

This skill follows the Agent Skills directory shape:

skills/network-optimizer-skill/
  SKILL.md
  scripts/
  references/
  assets/

Copy skills/network-optimizer-skill into the skill directory supported by your agent client, or use the helper:

git clone https://github.com/6Kmfi6HP/network-optimizer-skill.git
cd network-optimizer-skill
./install.sh agents-user

Ask your agent:

Use Network Optimizer Skill to diagnose and safely improve this computer's network speed and stability.

The skill prefers these bundled helpers when available:

# macOS or Linux diagnostics
skills/network-optimizer-skill/scripts/network-audit.sh before
skills/network-optimizer-skill/scripts/network-audit.sh after

# Windows diagnostics
powershell -ExecutionPolicy Bypass -File skills/network-optimizer-skill/scripts/windows-network-audit.ps1 -Phase before
powershell -ExecutionPolicy Bypass -File skills/network-optimizer-skill/scripts/windows-network-audit.ps1 -Phase after

# Compare before/after audit directories
python3 skills/network-optimizer-skill/scripts/compare-network-runs.py BEFORE_DIR AFTER_DIR

# Linux BBR/FQ diagnosis and explicit apply modes
skills/network-optimizer-skill/scripts/linux-bbr-fq.sh diagnose
skills/network-optimizer-skill/scripts/linux-bbr-fq.sh plan bbr
skills/network-optimizer-skill/scripts/linux-bbr-fq.sh plan bbr-fq
sudo skills/network-optimizer-skill/scripts/linux-bbr-fq.sh apply bbr-fq

The Linux optimization branch is intentionally narrow and evidence-driven:

• bbr means net.ipv4.tcp_congestion_control=bbr.
• bbr-fq means net.ipv4.tcp_congestion_control=bbr plus net.core.default_qdisc=fq.
• The helper checks kernel support and tries to load tcp_bbr only in apply mode.
• The helper writes one managed sysctl file: /etc/sysctl.d/90-network-optimizer-bbr.conf.
• The helper records a backup in /var/tmp/network-optimizer-skill-bbr-backup-*.env.
• It does not silently replace live interface qdiscs with tc qdisc replace; that can disrupt traffic and must be a separate, explicit operator decision.

The skill is intentionally conservative:

• No destructive network resets.
• No deleting network services, routes, VPN profiles, or firewall rules.
• No sudo, DNS changes, service-order changes, disabling services, BBR/FQ changes, cache flushes, or process stops without explaining risk and asking first.
• Reversible changes only, with original state recorded.
• Special warnings for SSH/remote sessions and VPN/Tailscale/WireGuard/Shadowrocket/Stash/Clash/Surge-style routing.

.codex-plugin/plugin.json                  Codex plugin manifest
.agents/plugins/marketplace.json           Codex repo marketplace
.claude-plugin/plugin.json                 Claude Code plugin manifest
.claude-plugin/marketplace.json            Claude Code marketplace
PROMOTION.md                               Launch links and shareable copy
skills/network-optimizer-skill/SKILL.md    Cross-agent skill
skills/network-optimizer-skill/scripts/    Audit, BBR/FQ, and comparison helpers
skills/network-optimizer-skill/references/ Evidence-backed procedures

• OpenAI Codex Agent Skills and plugin distribution docs: https://developers.openai.com/codex/skills
• OpenAI Codex plugin build docs: https://developers.openai.com/codex/plugins/build
• Claude Code plugin docs: https://code.claude.com/docs/en/plugins
• Agent Skills specification: https://agentskills.io/specification
• Linux default_qdisc sysctl docs: https://www.kernel.org/doc/html/latest/admin-guide/sysctl/net.html
• Linux tcp_congestion_control sysctl docs: https://www.kernel.org/doc/html/latest/networking/ip-sysctl.html
• tc-fq(8) manual: https://www.man7.org/linux/man-pages/man8/FQ.8.html
• Google BBR quick start: https://github.com/google/bbr/blob/master/Documentation/bbr-quick-start.md
• Microsoft Test-NetConnection: https://learn.microsoft.com/en-us/powershell/module/nettcpip/test-netconnection
• Microsoft DNS client cmdlets: https://learn.microsoft.com/en-us/powershell/module/dnsclient/