Tooluck logoTooluck
SKILL.md

debugging-network-issues

Agent skill fromdaymade/claude-code-skills

Investigates network, streaming and protocol failures with falsification-first layered experiments, the general fallback for unknown root causes. Use for ECONNRESET / RST_STREAM / SSE stalls, CDN/CGNAT timeouts or certificate errors, throughput collapse where everything returns 200 but transfers crawl, or LAN identity/topology mysteries. Not for known Tailscale/TUN/DNS/proxy-path conflicts (use tunnel-doctor).

How to install debugging-network-issues

install debugging-network-issues
# install the claude-code-skills pack with the skills CLI
npx skills add daymade/claude-code-skills

# or add only this skill to Claude Code: copy the folder

debugging-network-issues/

# into

~/.claude/skills/debugging-network-issues/ (all projects)

.claude/skills/debugging-network-issues/ (one project)

debugging-network-issues/SKILL.md

MITFull file
1# Debugging Network Issues
2
3Evidence-driven investigation methodology for incidents where the obvious cause is probably wrong. Built from a real 5-hour production case (see [references/case-sse-rst-130s.md](references/case-sse-rst-130s.md)) where assumption-stacking wasted hours that a 10-minute layered experiment would have resolved.
4
5Apply this skill when the user reports a network/streaming/protocol symptom and the investigator feels tempted to diagnose from one log line or one circumstantial data point. The skill's job is to slow that reflex down.
6
7## Triage first — is this a known domain?
8
9Before applying the general methodology below, check whether the symptom points at a stack that already has a dedicated skill in this repo. Those carry the domain-specific symptom→cause→fix tables this skill deliberately stays general about — start there, and come back here for methodology if the root cause turns out to be elsewhere.
10
11| If the symptom is… | Start with |
12| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
13…

Excerpt shown under the repository's MIT license.

More skills in claude-code-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates