Network Troubleshooting

Use when diagnosing network failures such as connection refusals, timeouts, TLS errors, DNS problems, or intermittent connectivity across local, cloud, container, or cluster environments.

9 stars 3 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill network-troubleshooting
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/network-troubleshooting ~/.claude/skills/network-troubleshooting

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Network Troubleshooting

## Purpose

Locate a network failure at the narrowest layer supported by evidence instead of guessing. Preserve the original error, test from the environment where it fails, and stop escalation when a lower layer has not been proven healthy.

## Safety and scope

- Begin with read-only diagnostics and a single reproducible symptom.
- Do not scan unrelated hosts, capture payloads, change firewall rules, restart production services, or alter kernel/network settings without explicit authorization.
- Redact credentials, tokens, private payloads, and internal topology before saving or sharing evidence.
- Use bounded timeouts and low request counts; record the source environment, timestamp, resolver, destination, and command exit status.
- Treat a successful test from a laptop as weak evidence when the failure occurs in a pod, worker, VPC, or customer network.

## Inputs and outputs

Capture the exact error and client, destination and port, failing and succeeding locations, frequency, recent deploy/config changes, and whether the issue is size- or load-dependent.

Produce a short report containing:

1. symptom and impact window;
2. tested path and environment;
3. evidence for each layer;
4. failing layer and confidence, or an explicit unknown;
5. smallest authorized fix;
6. verification from the original failing location; and
7. rollback and follow-up telemetry if a change was made.

## Layer-by-layer workflow
Read the full skill on GitHub

Details

Skill name
network-troubleshooting
Path
skills/network-troubleshooting/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Network Troubleshooting skill do?

Use when diagnosing network failures such as connection refusals, timeouts, TLS errors, DNS problems, or intermittent connectivity across local, cloud, container, or cluster environments.

How do I install the Network Troubleshooting skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill network-troubleshooting. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Network Troubleshooting popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.