network-diagnostics

majiayu000's avatarfrom majiayu000

Automated network troubleshooting and diagnostics for WSL/Linux environments

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026
[IT Helpdesk and Runbooks]

When & Why to Use This Skill

This Claude skill automates network troubleshooting and diagnostics specifically for WSL and Linux environments. It streamlines the process of identifying and resolving common networking bottlenecks, including MTU mismatches, DNS resolution failures, and firewall misconfigurations, while providing automated scripts for persistent fixes and rollback mechanisms.

Use Cases

  • Resolving WSL connectivity issues by identifying and adjusting MTU settings to match host network requirements.
  • Diagnosing DNS resolution errors by analyzing /etc/resolv.conf and testing connectivity with external name servers like 8.8.8.8.
  • Performing comprehensive connectivity audits using ping, traceroute, and port testing (nc/telnet) to isolate network breaks.
  • Auditing and modifying iptables rules and routing tables to ensure proper traffic flow in virtualized Linux environments.
  • Automating the generation of shell scripts to persist network configuration changes and service fixes across system reboots.
namenetwork-diagnostics
descriptionAutomated network troubleshooting and diagnostics for WSL/Linux environments

Network-diagnostics

Instructions

For network troubleshooting:

  1. MTU Issues (common in WSL)
    • Check current MTU: ip link show
    • Test different MTU: sudo ip link set dev eth0 mtu 1350
    • Common WSL MTU: 1300-1400
  2. DNS Resolution
    • Check /etc/resolv.conf
    • Test with: dig google.com, nslookup google.com
    • Try different DNS: 8.8.8.8, 1.1.1.1
  3. Connectivity Tests
    • Ping gateway: ip route | grep default
    • Traceroute to destination
    • Test ports: nc -zv host port, telnet host port
  4. Firewall/Routing
    • Check iptables: sudo iptables -L
    • Review routes: ip route show
    • WSL: Check Windows Firewall
  5. Service Status
    • Verify service is running
    • Check listening ports: ss -tlnp, netstat -tlnp
  • Generate scripts to persist fixes
  • Include checks for WSL vs native Linux
  • Add rollback mechanisms

Examples

Add examples of how to use this skill here.

Notes

  • This skill was auto-generated
  • Edit this file to customize behavior