
Network Troubleshooting & Root Cause Diagnostic System
Diagnose network issues systematically using Claude's root cause analysis
What You Can Do
Feed Claude raw diagnostic data—logs, traceroutes, packet captures, DNS queries, configuration files—and receive structured root cause analysis that distinguishes between client-side, LAN, WAN, infrastructure, and application-layer problems. Claude builds systematic decision trees that eliminate unlikely causes, cross-references symptoms against known issues and edge cases, and generates step-by-step workflows tailored to your environment with clear escalation recommendations.
Features
simultaneously analyze logs, traceroutes, netstat output, packet captures, and config files to build comprehensive diagnostic picture
eliminate unlikely causes through logical deduction and narrow scope between client, LAN, WAN, infrastructure, and application layers
cross-reference symptoms against known issues, configuration mismatches, and less common edge cases specific to your topology
generate step-by-step troubleshooting procedures tailored to your specific infrastructure and problem domain
create evidence-backed recommendations with reasoning trails for handoff to specialized teams or vendors
diagnose spanning tree loops, routing issues, firewall rules, DNS resolution, packet loss, and latency problems
handle geographically dispersed systems, cloud-on-premises connectivity, and complex multi-cloud network architectures
rank competing hypotheses by likelihood when multiple causes could explain observed symptoms
Example Output
Example 1: Intermittent Connectivity Issue
Input: ping output showing 30% packet loss, tracert stopping at ISP gateway, recent firewall rule change, latency spike in NetFlow data
Output:
Likely Root Cause: MTU mismatch or fragmentation issue post-firewall rule change
Diagnostic Steps:
1. Verify MTU size across WAN link (expect 1500 baseline)
2. Check firewall rule for ICMP fragmentation-needed blocks
3. Capture packet traces at interface before/after firewall
Escalation: If MTU confirmed, engage ISP for path validation
Example 2: Slow Remote VPN Performance
Input: Syslog from VPN concentrator, client-side netstat, bandwidth utilization graph, DNS query logs
Output:
Scope Analysis:
- VPN tunnel itself: ✓ Healthy (throughput logs nominal)
- DNS resolution: ⚠ Degraded (18% timeout rate to primary resolver)
- Client-side: ✓ Normal TCP retransmits
Root Cause: DNS resolver failover not working; clients timeout waiting for primary before retry
Immediate Fix: Force secondary DNS on VPN profile
Long-term: Implement local DNS proxy at VPN gateway
What's Included
- SKILL.md instruction file with diagnostic framework and decision logic:
- Data Collection Template: checklist of logs, captures, and outputs to gather before diagnosis
- Multi-Source Analysis Framework: structured format for combining ping, tracert, netstat, syslog, and packet capture data
- Layer 2/3/4 Decision Tree: flowchart for narrowing scope across network stack layers
- Escalation Documentation Template: structured format for handoff to specialized teams with evidence and recommendations
Who It's For
- Technical Support Engineers — troubleshoot tier-2/3 connectivity issues and escalate with confidence
- Network Administrators — diagnose performance problems and configuration issues across your infrastructure
- Systems Engineers — analyze hybrid and cloud-on-premises connectivity problems efficiently
- SOC Analysts — distinguish between security-related and legitimate network performance issues
- IT Helpdesk Supervisors — document and escalate complex network problems with supporting evidence
Best For
- Intermittent or vague connectivity symptoms (slow network, random drops, timeouts)
- Multi-source diagnostic data analysis (combining logs, packet captures, configs, performance metrics)
- Root cause narrowing when multiple infrastructure layers could be responsible
- Complex hybrid/multi-cloud network topologies and geographically dispersed systems
- Escalation documentation and post-mortem analysis with reasoning trails







