Skip to main content
affpapa.org
RU EN
skill CX Codex

network-debugging — Claude Code skill: diagnose network failures

Walks your agent through why requests fail, stall or crawl. Useful when the app is slow and the network is the suspect.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add aj-geddes/useful-ai-prompts --skill network-debugging -a claude-code
Open on GitHub

What network-debugging does

The skill points the agent at the browser's network tab and at how data actually moves. It reads request statuses, initiators, sizes and the waterfall timeline — queueing, DNS, the TCP handshake, SSL/TLS negotiation, time to first byte, content download. That breakdown shows where the time goes.

Four reference guides ship in the references/ directory: browser network tools, common network issues, debugging tools and techniques, and a checklist. The quick start covers the Network tab columns and the timeline stages, plus throttling presets such as Fast 3G. There is nothing to run on its own, and without browser developer tools the skill has nothing to read.

The listed cases are slow loading, failed requests, intermittent connectivity, CORS errors, SSL/TLS problems and API communication failures. An error outside that set is a poor fit.

What it helps with

  • pin down which stage of a request eats the time
  • trace a CORS failure between frontend and API
  • tell an SSL/TLS problem apart from a slow server
  • catch connectivity that drops in and out
  • see how the app behaves on a throttled connection

Example prompts for the agent

  • Figure out why the request to /api/orders fails with a CORS error
  • Read the request timeline and tell me where the time goes
  • Check how the app behaves under Fast 3G throttling

How to install network-debugging

1Skills CLI (Vercel)

npx skills add aj-geddes/useful-ai-prompts --skill network-debugging -a claude-code

2Manually: put the files in place

~/.claude/skills/network-debugging/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/network-debugging/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about network-debugging

How do I install network-debugging in Claude?

Run npx skills add aj-geddes/useful-ai-prompts --skill network-debugging -a claude-code. The skill lands at ~/.claude/skills/network-debugging/SKILL.md.

What does network-debugging do?

It helps the agent diagnose network failures: slow loading, failed requests, intermittent connectivity, CORS errors and SSL/TLS issues. It works from the browser Network tab and the request timeline.

What do I need for it to work?

Access to browser developer tools. Without them there are no statuses, initiators or waterfall timings to read.

Source text

SKILL.md · MIT 
---
name: network-debugging
description: >
  Debug network issues using browser tools and network analysis. Diagnose
  connection problems, latency, and data transmission issues.
---

# Network Debugging

## Table of Contents

- [Overview](#overview)
- [When to Use](#when-to-use)
- [Quick Start](#quick-start)
- [Reference Guides](#reference-guides)
- [Best Practices](#best-practices)

## Overview

Network debugging identifies connectivity issues, latency problems, and data transmission errors that impact application performance.

## When to Use

- Slow loading times
- Failed requests
- Intermittent connectivity
- CORS errors
- SSL/TLS issues
- API communication problems

## Quick Start

Minimal working example:

```yaml
Chrome DevTools Network Tab:

Columns:
  - Name: Request file/endpoint
  - Status: HTTP status code
  - Type: Resource type (xhr, fetch, etc)
  - Initiator: What triggered request
  - Size: Resource size / transferred size
  - Time: Total time to complete
  - Waterfall: Timeline visualization

Timeline Breakdown:
  - Queueing: Waiting in queue
  - DNS: Domain name resolution
  - Initial connection: TCP handshake
  - SSL: SSL/TLS negotiation
  - Request sent: Time to send request
  - Waiting (TTFB): Time to first byte
  - Content Download: Receiving response

---
Network Conditions:

Throttling Presets:
  - Fast 3G: 1.6 Mbps down, 750 Kbps up
// ... (see reference guides for full implementation)
```

## Reference Guides

Detailed implementations in the `references/` directory:

| Guide | Contents |
|---|---|
| [Browser Network Tools](references/browser-network-tools.md) | Browser Network Tools |
| [Common Network Issues](references/common-network-issues.md) | Common Network Issues |
| [Debugging Tools & Techniques](references/debugging-tools-techniques.md) | Debugging Tools & Techniques |
| [Checklist](references/checklist.md) | Checklist |

## Best Practices

### ✅ DO

- Follow established patterns and conventions
- Write clean, maintainable code
- Add appropriate documentation
- Test thoroughly before deploying

### ❌ DON'T

- Skip testing or validation
- Ignore error handling
- Hard-code configuration values

© aj-geddes · MIT · aj-geddes/useful-ai-prompts

Similar skills

All skills for Browser and scraping →
network-request-auditing spencerpauly Audits browser fetch and XHR calls after UI interactions to find errors, duplicate requests, and latency issues. Useful for API-heavy pages and backend changes. CX Codex +1 435installs debugging-network-issues daymade A methodology for network, streaming and protocol failures where the obvious cause is probably wrong. CX Codex +1 675installs cookie-debugging ChromeDevTools Skill for inspecting cookies, sessions, and authentication errors via Chrome DevTools MCP. Diagnoses 401/403, auth redirects, Set-Cookie issues, and verifies cookie consent compliance. CX Codex +1 870installs dt-obs-network-flows Dynatrace A Dynatrace skill that reads network flows from three sources and answers who talks to whom and where connections break. CX Codex +1 912installs dt-obs-network-devices Dynatrace This skill reads SNMP monitoring data in Dynatrace: device inventory, interface state, topology and logs. Useful when a port is down or a switch is saturated. CX Codex +1 907installs analyzing-network-flow-data-with-netflow mahipal This skill parses NetFlow v9 and IPFIX records to spot volumetric anomalies, port scanning, data exfiltration and C2 beaconing. CX Codex +1 372installs

From the same set118

Causal Inference A skill that walks your agent through causal effect estimation: propensity scores, instrumental variables, causal graphs. Useful when a randomized experiment isn't an option. CX Codex +1 534installs code-generation-template A skill for generating code from templates: project scaffolding, boilerplate, AST-based generation and template engines. Useful when you need to produce repetitive code fast. CX Codex +1 532installs grpc-service-development This skill walks your agent through gRPC service work: Protocol Buffers contracts, four call patterns, servers in Node.js and Python. CX Codex +1 527installs gap-analysis Compares your current state with the desired one and lists what is missing. Useful before big investments or a roadmap rewrite. CX Codex +1 526installs payment-gateway-integration A skill for wiring Stripe, PayPal and Square into your backend: charges, subscriptions, webhooks. Useful when you build billing or a store. CX Codex +1 524installs progressive-web-app Guides your agent through building a progressive web app: manifest, service worker, offline mode and installability. CX Codex +1 522installs sql-query-optimization This skill digs into slow SQL queries on PostgreSQL and MySQL: execution plans, indexes, rewriting. Useful when a query drags and you can't tell why. CX Codex +1 520installs kpi-dashboard-design Walks an agent through picking metrics and building a dashboard that shows goal progress. Useful for leadership reporting or process monitoring. CX Codex +1 520installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor