debugging-network-issues SKILL.md skillB

debugging-network-issues from daymade/claude-code-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add daymade/claude-code-skills/debugging-network-issues@git:20261106.2ee102b

Pins git:20261106.2ee102b in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
daymade/claude-code-skills
Path
debugging-network-issues/SKILL.md
Versions recorded
14
Latest version
git:20261106.2ee102b, committed Nov 6, 2026
First version recorded
Aug 17, 2026
Size
60,494 bytes
Repository stars
1,519
License
MIT

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).

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Debugging Network Issues

Evidence-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.

Apply 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.

## Triage first — is this a known domain?

Before 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.

| If the symptom is…                                                                                                                                                                                       | Start with                                   |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add daymade/claude-code-skills/debugging-network-issues@sha256:adfa62199a7e36b1

The line at the top of this page pins the label git:20261106.2ee102b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_hrpyi5dyasl24gyz.svg)](https://markdownregistry.com/a/art_hrpyi5dyasl24gyz)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 14 versions of this file, between Aug 17, 2026 and Nov 6, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261106.2ee102b latest2026-11-06 2ee102b 60,494 BB view · diff
git:20261105.dcd38452026-11-05 dcd3845 58,867 BB view · diff
git:20261023.706a4762026-10-23 706a476 58,803 BB view · diff
git:20261020.7e4a8f62026-10-20 7e4a8f6 58,769 BB view · diff
git:20261020.b6d8d4b2026-10-20 b6d8d4b 58,921 BB view · diff
git:20261017.a1e71442026-10-17 a1e7144 58,796 BB view · diff
git:20261017.bbe7a122026-10-17 bbe7a12 58,277 BB view · diff
git:20261004.7930e682026-10-04 7930e68 57,884 BB view · diff
git:20261004.d6ecf572026-10-04 d6ecf57 57,879 BB view · diff
git:20260923.d6fdd9a2026-09-23 d6fdd9a 55,115 BB view · diff
git:20260912.e81fa7a2026-09-12 e81fa7a 55,593 BB view · diff
git:20260910.ccb127c2026-09-10 ccb127c 53,419 BB view · diff
git:20260824.3a836222026-08-24 3a83622 50,663 BB view · diff
git:20260817.4ef06b22026-08-17 4ef06b2 49,668 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (60494 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

daymade/claude-code-skills · 1,519 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hrpyi5dyasl24gyz
GET https://markdownregistry.com/api/v1/resolve?ref=daymade/claude-code-skills/debugging-network-issues
GET https://markdownregistry.com/api/v1/blob/adfa62199a7e36b1417bbb48991833b7028c89fa9afbece842defe749f0bfbc4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from daymade/claude-code-skills

AGENTS.md AGENTS.md file
daymade/claude-code-skills · AGENTS.md
git:20260111.8c1ef43 · audit B · 1,519 stars
CLAUDE.md CLAUDE.md file
daymade/claude-code-skills · CLAUDE.md
git:20261102.47ce772 · audit B · 1,519 stars
app-evolver SKILL.md skill
daymade/claude-code-skills · app-evolver/SKILL.md · Improves an existing application using its code, product contract, authorized work history and competitor evidence. Use…
git:20261030.b00a0eb · audit A · 1,519 stars
auto-repo-setup SKILL.md skill
daymade/claude-code-skills · auto-repo-setup/SKILL.md · Diagnoses and repairs repository setup and guarded Git workflows for Claude Code or Codex — environment repair, startup…
git:20261031.6412ac3 · audit B · 1,519 stars
bilibili-source SKILL.md skill
daymade/claude-code-skills · bilibili-source/SKILL.md · Fetches real, citable Bilibili (B站) video data — stats, metadata, tags, and full danmaku text — via login-free API…
git:20261002.2b7a15b · audit A · 1,519 stars
cli-demo-generator SKILL.md skill
daymade/claude-code-skills · cli-demo-generator/SKILL.md · Generates professional animated CLI demos as GIFs using VHS terminal recordings. Use to create terminal demos, record…
git:20260923.943df48 · audit A · 1,519 stars
cloudflare-troubleshooting SKILL.md skill
daymade/claude-code-skills · cloudflare-troubleshooting/SKILL.md · Investigate and resolve Cloudflare configuration issues using API-driven evidence gathering. Use when troubleshooting…
git:20261024.1794d99 · audit A · 1,519 stars
competitors-analysis SKILL.md skill
daymade/claude-code-skills · competitors-analysis/SKILL.md · Clones and audits competitor repositories into evidence-based intelligence with file:line citations. Use to track…
git:20261018.4f86ca5 · audit A · 1,519 stars
cookie-copy SKILL.md skill
daymade/claude-code-skills · cookie-copy/SKILL.md · Copies selected-site cookies between local profiles of the same macOS Chrome. Use for cookie copy, 复制 Cookie, 搬登录态 or…
git:20261026.e71a26f · audit A · 1,519 stars
data-visualization-discipline SKILL.md skill
daymade/claude-code-skills · data-visualization-discipline/SKILL.md · 数据可视化的判断层 SSOT——画任何图表、dashboard、看板之前先加载它,不是画完之后。管"该不该这么画":这张图想让读者得出什么结论、用均值还是中位数、能不能聚合、堆叠还是折线、能不能上双轴、配色与颜色数量、同一实体跨图是否同色同…
git:20261106.96ac10e · audit A · 1,519 stars
asr-transcribe-to-text SKILL.md skill
daymade/claude-code-skills · daymade-audio/asr-transcribe-to-text/SKILL.md · Transcribes audio or video to speaker-labeled, timestamped text, locally with MLX on Apple Silicon or remotely. Use for…
git:20261031.9d5ef22 · audit A · 1,519 stars
audio-router SKILL.md skill
daymade/claude-code-skills · daymade-audio/audio-router/SKILL.md · Routes audio: StepFun ASR/语音识别, StepFun TTS/配音, transcript/妙记→会议纪要, merge/review minutes. Reads one bundled specialist…
git:20260924.13f4279 · audit A · 1,519 stars

Every file in daymade/claude-code-skills

Browse by kind, by grade B, or by owner.