К основному содержанию
скилл CX Codex

network-troubleshooting — скилл для Claude Code: диагностика сети

Скилл network-troubleshooting для Claude Code разбирает сетевые сбои в командах и сервисах. Запускается при ошибках DNS, TLS, прокси, соединения или тайм-аутах реестра пакетов.

Apache-2.0 131 установок ★ 312 обновлён 2026-10-08

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Mindrally/skills --skill network-troubleshooting -a claude-code
Открыть на GitHub

Что делает network-troubleshooting

Скилл помогает выяснить причину сетевой ошибки: отказа в соединении, сбоя DNS, проблемы с TLS-сертификатом, прокси или тайм-аута реестра пакетов. Он собирает текст ошибки и команду, определяет категорию сбоя, а затем предлагает проверку для конкретного узла, URL или порта.

Проверки остаются только для чтения и не затрагивают посторонние узлы. Скилл не должен выводить конфигурацию с секретами или отключать проверку сертификатов. Изменять настройки сети, прокси, Git или других систем можно только после явного согласия на конкретное действие.

Какие задачи решает

  • найти причину отказа подключения к сервису
  • разобрать ошибку DNS при обращении к узлу
  • проверить TLS-сертификат без отключения его верификации
  • выяснить, связана ли ошибка npm или pip с реестром пакетов
  • отделить сбой прокси от ошибки удалённого сервиса

Примеры запросов агенту

  • Разбери ошибку curl: соединение с api.example.com отклонено.
  • Помоги выяснить, почему npm install завершается тайм-аутом.
  • Проверь, связана ли ошибка сертификата Git с TLS на удалённом узле.

Как установить network-troubleshooting

1Через Skills CLI (Vercel)

npx skills add Mindrally/skills --skill network-troubleshooting -a claude-code

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/network-troubleshooting/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о network-troubleshooting

Как установить network-troubleshooting в Claude Code?

Выполни npx skills add Mindrally/skills --skill network-troubleshooting -a claude-code. Скилл устанавливается в ~/.claude/skills/network-troubleshooting/SKILL.md.

Что делает network-troubleshooting?

Скилл классифицирует сетевые ошибки и подбирает ограниченные диагностические проверки для проблемного узла. Он объясняет результаты до предложения исправлений.

Как network-troubleshooting проверяет сетевые сбои?

Он использует проверки только для чтения и только для указанного проблемного узла. Отключать проверку TLS или менять настройки без явного согласия нельзя.

Исходный текст

SKILL.md · Apache-2.0
---
name: network-troubleshooting
description: "Systematic, safety-first diagnosis of developer network failures such as connection refused, DNS resolution errors, TLS certificate problems, proxy failures, and package registry timeouts. Use when a command fails with a network-shaped error (curl, npm, pip, git, docker), when a service is unreachable, or when the user asks to debug connectivity, DNS, TLS, or proxy issues."
metadata:
  maintainer: Mindrally
  source: https://github.com/Mindrally/skills
---

# Network Troubleshooting

This skill provides a concise, safety-first decision guide for diagnosing developer network failures. Diagnostics must stay read-only and target-scoped — this is not an automated remediation toolkit.

## Safety Boundaries

These boundaries apply to every step of the workflow below and must never be relaxed, even if asked:

- Prefer read-only diagnostics and trusted project-provided diagnostic scripts.
- Use the failing host, URL, registry, or service as the default probe target — do not probe unrelated hosts.
- Ask before probing unrelated external services.
- Never print proxy URLs, credentials, tokens, auth headers, package index URLs, registry hostnames from config, or raw config values in shared output.
- Internal hosts and URLs may be collected for target-scoped local diagnostics, but replace them with placeholders before sharing logs or reports unless the user explicitly approves including them.
- Never dump local configuration from npm, pnpm, yarn, pip, Git, Docker, shell, OS proxy, VPN, or certificate stores.
- Never disable, bypass, or skip TLS or certificate verification (no `-k`/`--insecure`, no `NODE_TLS_REJECT_UNAUTHORIZED=0`, no `verify=False`), even temporarily "just to test."
- Never change OS networking, DNS, proxy, package manager, Git, Docker, shell, VPN, or trust-store settings without explicit user approval for the exact action being taken.

## Workflow

1. **Collect** — Capture the exact error text, the failing command, the target host/URL/port, OS/shell, proxy/VPN context, and whether the failure affects one target or many.
2. **Classify** — Match the symptom against the error classification table below to form a hypothesis.
3. **Diagnose** — Run only read-only checks scoped to the failing target, starting with the smallest relevant check.
4. **Explain** — Interpret each diagnostic result in plain language before suggesting any fix.
5. **Advise** — Present remediation options as choices; wait for explicit user approval before changing any state.
6. **Verify** — After an approved change, re-run the original failing command or an equivalent target-scoped check.

## Error Classification

| Error Pattern | Likely Category |
|---|---|
| `ECONNREFUSED`, `ERR_CONNECTION_REFUSED`, `Connection refused` | Target service or port is not listening |
| `ECONNRESET`, `socket hang up`, `Connection reset` | Connection dropped by target, proxy, firewall, or middlebox |
| `ETIMEDOUT`, `ERR_CONNECTION_TIMED_OUT`, `timed out` | Routing, firewall, proxy, or target availability |
| `ENOTFOUND`, `EAI_NONAME`, `ERR_NAME_NOT_RESOLVED`, `getaddrinfo` | DNS or hostname issue |
| `ERR_PROXY_CONNECTION_FAILED`, proxy tunnel errors, HTTP `407` | Proxy configuration or proxy authentication |
| `UNABLE_TO_VERIFY_LEAF_SIGNATURE`, `CERT_HAS_EXPIRED`, `self signed`, `ERR_CERT_*` | TLS certificate or local trust issue |
| HTTP `403` | Authorization, IP allowlist, CORS, or policy block |
| HTTP `502`, `503`, `504` | Upstream service, gateway, CDN, or transient server issue |
| `npm ERR! network`, package install timeout, `pip` timeout | Package registry, proxy, DNS, or network path issue |
| `fatal: unable to access`, Git fetch/push timeout | Git remote, proxy, DNS, TLS, or network path issue |

## Safe Target-Scoped Checks

Choose the smallest relevant check and explain what it does before running it. Always substitute the specific failing `<target-host>`, `<port>`, and `<path>` — never a broader or unrelated target.

### Connectivity

Linux/macOS:

```bash
ping -c 4 <target-host>
curl -v telnet://<target-host>:<port> --connect-timeout 5
```

Windows PowerShell:

```powershell
Test-Connection -ComputerName <target-host> -Count 4
Test-NetConnection -ComputerName <target-host> -Port <port>
```

### DNS

Linux/macOS:

```bash
nslookup <target-host>
dig <target-host>
```

Windows PowerShell:

```powershell
Resolve-DnsName <target-host>
```

### HTTP

Linux/macOS:

```bash
curl -vvv -o /dev/null -w "HTTP %{http_code}\nTime: %{time_total}s\nDNS: %{time_namelookup}s\nConnect: %{time_connect}s\nTLS: %{time_appconnect}s\n" https://<target-host>/<path>
curl -I https://<target-host>/<path>
```

Windows PowerShell:

```powershell
$uri = "https://<target-host>/<path>"
try {
  $resp = Invoke-WebRequest -Uri $uri -Method Head -TimeoutSec 10
  "HTTP status: $([int]$resp.StatusCode)"
} catch [Net.WebException] {
  if ($_.Exception.Response) {
    "HTTP status: $([int]$_.Exception.Response.StatusCode)"
  } else {
    "HTTP request failed: $($_.Exception.Message)"
  }
}
```

### TLS

Linux/macOS:

```bash
openssl s_client -connect <target-host>:<port> -servername <target-host> -showcerts </dev/null
echo | openssl s_client -connect <target-host>:<port> -servername <target-host> 2>/dev/null | openssl x509 -noout -subject -issuer -dates
```

Windows PowerShell — check the certificate and HTTP status separately so a non-2xx response is never mislabeled as a certificate failure:

```powershell
try {
  $req = [Net.HttpWebRequest]::Create("https://<target-host>:<port>/<path>")
  $req.Method = "HEAD"
  $req.Timeout = 5000
  try {
    $resp = $req.GetResponse()
  } catch [Net.WebException] {
    $resp = $_.Exception.Response
    if ($req.ServicePoint.Certificate) {
      $cert = $req.ServicePoint.Certificate
      "Cert subject: $($cert.Subject)"
      "Cert expires: $($cert.GetExpirationDateString())"
    }
    if ($resp) {
      "HTTP status: $([int]$resp.StatusCode) $($resp.StatusDescription)"
      $resp.Close()
    } else {
      "TLS/network error: $($_.Exception.Message)"
    }
    return
  }
  $cert = $req.ServicePoint.Certificate
  if ($cert) {
    "Cert subject: $($cert.Subject)"
    "Cert expires: $($cert.GetExpirationDateString())"
  }
  "HTTP status: $([int]$resp.StatusCode) $($resp.StatusDescription)"
  $resp.Close()
} catch {
  "TLS/network error: $($_.Exception.Message)"
}
```

### Proxy and Package Managers

- Avoid raw config reads for proxy, package manager, Git, Docker, or OS network configuration.
- Report only whether relevant settings appear present when this can be checked without printing values.
- If the available command would print a URL, token, internal hostname, auth header, or full config value, do not run it.
- Only perform package registry probes when the failed operation already targeted that registry, or after the user approves that exact probe target.

## User-Approved Remediation Options

Present these as choices for the user to approve — never apply them automatically.

| Diagnosis | Safe Advice |
|---|---|
| Target service is not listening | Check whether the local or remote service is running and whether the expected port is correct. |
| DNS lookup fails | Check the hostname, hosts-file expectations, DNS service status, or approved DNS changes. |
| Proxy appears required or unavailable | Ask whether the user wants to start or adjust the proxy/VPN, then verify only the approved target. |
| TLS certificate expired | Renew or replace the certificate, fix system time, install a trusted local development CA, or update the trust store. Never bypass TLS verification. |
| TLS unknown CA | Import the correct CA into the appropriate trust store after the user confirms the source and scope. |
| HTTP `407` | Ask the user to confirm proxy authentication requirements before changing credentials or tool settings. |
| HTTP `403` | Check authentication, API key scope, IP allowlist, CORS policy, or service policy. |
| HTTP `502`/`503`/`504` | Treat as upstream or gateway instability; check status pages when approved and retry with backoff. |
| Package install timeout | Discuss approved registry, proxy, or network-path options without printing or changing stored config values. |
| Git network failure | Discuss approved remote URL, proxy, credential, TLS, or network-path options without changing global Git settings automatically. |
| Docker pull failure | Discuss approved registry mirror, proxy, or daemon settings as a user-approved configuration change. |

## Verification

- After any user-approved change, re-run the original failing command whenever possible.
- If a smaller check is needed instead, keep it scoped to the same failing host, URL, registry, or service.
- Always explain what each diagnostic result means before recommending the next step.

© Mindrally · Apache-2.0 · Mindrally/skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
network-troubleshoot PatrickJS Правило network-troubleshoot ведёт агента через безопасную диагностику сетевых сбоев: от сбора ошибки до проверки результата. CX Codex +1 ★ 41 178звёзд репо startup-it-troubleshooting devops-skills Скилл startup-it-troubleshooting для Claude Code помогает разбирать типичные IT-сбои в небольших командах без штатного IT-специалиста. Включается для проблем с доступом, сетью, рабочими станциями и администрированием устройств. CX Codex +1 364установок hunt-tls-network Sachin Sharma Скилл hunt-tls-network по TLS/SSL и DNS на стороне цели: находит слабые шифры, висящие CNAME и открытый AXFR, а потом честно отделяет находки, которые примут, от шума про hardening. CX Codex +1 ★ 16 193звёзд репо network-engineer VoltAgent Субагент network-engineer разбирает сетевой путь, проблемы подключения, балансировку и изменения инфраструктуры. Он помогает найти причину и проверить безопасный откат. CX Codex ★ 6 505звёзд репо debugging-network-issues daymade Скилл debugging-network-issues для Claude Code структурирует диагностику сетевых сбоев, обрывов потоков и протокольных ошибок по уровням. Исключает ложные догадки при зависаниях SSE или таймаутах. CX Codex +1 740установок huawei-cloud-network-query huaweicloud Скилл huawei-cloud-network-query для Claude Code читает сетевые ресурсы Huawei Cloud локальными Python-скриптами. Используется для аудита инфраструктуры без изменений. CX Codex +1 18 400установок

Из того же набора247

Весь набор →
robocorp-cursor-rules Набор правил для ИИ-агента: как писать RPA-автоматизацию на Python под RoboCorp — функционально, с Pydantic и async. CX Codex +1 677установок parcel-bundler Скилл parcel-bundler для Claude Code задаёт агенту правила работы со сборщиком Parcel: точки входа, TypeScript, CSS-модули, кэш и продакшен-сборку. Описывает сборку проекта без конфига. CX Codex +1 674установок clean-code Скилл clean-code для Claude Code помогает писать и проверять понятный код без лишних абстракций. Включается при создании функций, рефакторинге и ревью. CX Codex +1 182установок embedded-stm32 Скилл embedded-stm32 для Claude Code и Codex задаёт правила разработки встроенного ПО на C/C++ под микроконтроллеры STM32 с библиотекой HAL. Включается при генерации кода в CubeMX, настройке DMA и обработке прерываний. CX Codex +1 132установок readme-best-practices Скилл readme-best-practices для Claude Code помогает писать и проверять README проектов. Он подключается при создании файла, переработке существующего README или оценке его качества. CX Codex +1 121установок security-devsecops Скилл security-devsecops для Claude Code и Codex направляет разработку по практикам DevSecOps и AppSec. Включается при работе с секретами, базой данных, аутентификацией или настройке CI/CD. CX Codex +1 117установок ros2-robotics Скилл ros2-robotics для Claude Code помогает разрабатывать пакеты и узлы ROS 2. Подключается при работе с топиками, QoS, tf2, файлами запуска или тестами рабочего пространства colcon. CX Codex +1 111установок blender-python-addon Скилл blender-python-addon для Claude Code задаёт правила разработки дополнений к Blender через API bpy. Подключается при создании операторов, панелей интерфейса и работе с bmesh. CX Codex +1 111установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой