network-diagnostics

Diagnose network connectivity issues with DNS, routing, port, and firewall checks.

Updated Dec 21, 2025
One-click install
npx skills add https://github.com/djcyphers/network-copilot-cli --skill network-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: network-diagnostics
Source: https://github.com/djcyphers/network-copilot-cli/tree/main/skills/network-diagnostics
Command: npx skills add https://github.com/djcyphers/network-copilot-cli --skill network-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses network connectivity issues: DNS, routing, firewall, port checks, and traceroutes. Helps troubleshoot server-to-server and client access problems with a clear path to resolution.

Core Features & Use Cases

  • End-to-End Checks: Ping, DNS resolution, and port accessibility across multiple hosts.
  • Route & Firewall Visibility: Analyze routes and firewall rules affecting connectivity.
  • Structured Output & Next Steps: Present tested items, results, and recommended next actions.

Quick Start

Test reachability and common services for a target host, then follow the recommended next steps.

Frequently Asked Questions about network-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose network connectivity issues between servers?

Network diagnostics tests DNS resolution, port accessibility, routing paths, and firewall rules to identify connectivity problems. Run checks against your target host to pinpoint whether the issue is DNS, routing, firewall, or port-related, then follow recommended next steps for resolution.

Can I use network diagnostics to troubleshoot connection refused and timeout errors?

Yes. Network diagnostics performs end-to-end checks including ping, DNS resolution, and port accessibility tests to isolate whether connection refused or timeout errors stem from DNS failure, unreachable routes, closed ports, or firewall blocking.

What checks does network diagnostics perform to test port accessibility?

Network diagnostics tests port accessibility by attempting TCP connections to specified ports on target hosts, analyzes firewall rules affecting those ports, and reports which ports are reachable or blocked to help identify access barriers.

How do I use traceroute and routing analysis to troubleshoot intermittent reachability?

Network diagnostics analyzes routing paths and performs traceroute checks to map the network route to your target. This reveals where packets are dropped or delayed, helping identify whether intermittent issues stem from routing problems or intermediate network nodes.

What does network diagnostics show about firewall rules affecting connectivity?

Network diagnostics analyzes firewall settings and their impact on connectivity to target hosts. It reports which firewall rules block or allow traffic, helping you determine whether firewall configuration is preventing access to required ports or services.

Can network diagnostics handle client-to-server and server-to-server outage scenarios?

Yes. Network diagnostics applies the same end-to-end diagnostic workflow—DNS, port, route, and firewall checks—to both client access and server-to-server connectivity scenarios to quickly identify outage root causes and recommend next steps.