{"enrichment":{"faq":[{"a":"debugging-network-issues applies falsification-first methodology to network and streaming incidents where the obvious cause is likely wrong. Use it when you face connection resets, SSE stalls, fixed-time drops, certificate errors, or LAN mysteries\u2014especially when symptoms like \"works sometimes\" or \"fails after N seconds\" suggest multiple possible layers. Rather than stacking assumptions, it guides you through layered isolation to pinpoint exactly which hop (client, CDN, proxy, or backend) is responsible.","q":"What is debugging-network-issues and when should I use it?"},{"a":"debugging-network-issues helps you separate these by testing the same request across different paths. Check reverse proxy access logs for bytes_read to see if the full body arrived; if it did but the response timed out, the backend is slow. If bytes_read is incomplete or the connection drops mid-upload, the upload itself is timing out. Test the same payload via direct connection, then through your CDN or proxy, to isolate which layer is enforcing the timeout.","q":"How do I distinguish upload timeout from backend processing timeout for large requests?"},{"a":"debugging-network-issues guides you to apply layered isolation: test the same request from different clients (direct, VPN, proxy, different network), to different endpoints (direct backend, CDN, reverse proxy), and capture packets at each hop. If ECONNRESET happens only through one path, that hop is responsible. Check for idle timeouts, certificate mismatches, or proxy rules. Use packet capture to see whether the RST comes from your client, the proxy, CDN, or backend.","q":"What does connection reset ECONNRESET debugging involve?"},{"a":"debugging-network-issues recommends testing the same request with and without your proxy/VPN enabled, and inspecting DNS resolution to confirm the CNAME is resolving to the expected IP. Check your proxy's rule override settings and verify that SSL certificate verification isn't failing due to hostname mismatches. Use packet capture or a network analyzer to confirm which IP your traffic is actually reaching, then compare against your CNAME rule configuration.","q":"How can I resolve client-side proxy or VPN misrouting and CNAME rule conflicts?"},{"a":"debugging-network-issues suggests scanning your LAN for mystery IPs and MAC addresses using ARP tables or network discovery tools. When topology changes cause connection drops at fixed intervals, check for DHCP lease expirations, gateway failovers, or TUN DNS hijacking. Correlate device appearance/disappearance with symptom timing. If getaddrinfo stalls, a resolver on your LAN may be misconfigured; test DNS directly against your gateway and upstream resolvers separately.","q":"How do I identify unknown LAN devices and diagnose subnet topology changes?"},{"a":"debugging-network-issues uses falsification-first methodology: instead of assuming the obvious cause, you systematically test each layer in isolation. For each symptom, vary one factor at a time\u2014client, path, endpoint, or timing\u2014and record which combinations fail. This layered isolation experiment setup reveals which hop is actually responsible. By falsifying assumptions rather than confirming them, you avoid chasing red herrings and reach the true root cause faster.","q":"What is the core methodology behind debugging-network-issues?"}],"shadow_tags":["evidence-driven-diagnosis","multi-layer-isolation","falsification-methodology","protocol-layer-bugs","streaming-interruption","upload-vs-processing","proxy-client-routing","packet-level-analysis","cognitive-trap-avoidance","instrumentation-patterns"],"summary_rewrite":"This skill applies falsification-first methodology to network and streaming incidents where the obvious cause is likely a red herring. Rather than stacking assumptions, it guides you through layered isolation\u2014testing the same request across different paths to pinpoint exactly which hop (client, CDN, proxy, or backend) is responsible. Use it for connection resets, SSE stalls, fixed-time drops, certificate errors, or LAN mysteries where symptoms like \"works sometimes\" or \"fails after N seconds\" point to multiple possible layers."},"files":[{"bytes":33234,"path":"debugging-network-issues/SKILL.md","sha256":"89efefeb583c4075851293e213d1ca5874e1b3574edbc27ffc54254693270362","url":"https://skillfed.io/files/daymade/claude-code-skills/debugging-network-issues/61378ed6/SKILL.md"}],"id":"daymade/claude-code-skills/debugging-network-issues","links":{"html":"https://skillfed.io/daymade/claude-code-skills/debugging-network-issues","md":"https://skillfed.io/daymade/claude-code-skills/debugging-network-issues.md","repo":"https://github.com/daymade/claude-code-skills"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":210,"language":"Python","last_updated":"2026-07-27","license":"MIT","name":"debugging-network-issues","publisher":"daymade","stars":1299},"relations":{"similar":[{"id":"sway913/wsl-singbox-tun/wsl-singbox-tun"},{"id":"daymade/claude-code-skills/tunnel-doctor"},{"id":"majiayu000/spellbook/rustdesk-doctor"},{"id":"majiayu000/spellbook/ip-check"},{"id":"blacklanternsecurity/red-run/pivoting-tunneling"},{"id":"affaan-m/ECC/uncloud"},{"id":"yaklang/hack-skills/tunneling-and-pivoting"},{"id":"dawiddutoit/custom-claude/caddy-subdomain-add"},{"id":"blacklanternsecurity/red-run/request-smuggling"},{"id":"elementalsouls/Claude-BugHunter/hunt-http-smuggling"}]},"slug":{"owner":"daymade","repo":"claude-code-skills","skill":"debugging-network-issues"},"version":"61378ed6"}