pyats-troubleshoot

Troubleshoot network issues using OSI-layer methodology with pyATS and NetBox.

627|175|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/automateyournetwork/netclaw --skill pyats-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pyats-troubleshoot
Source: https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/pyats-troubleshoot
Command: npx skills add https://github.com/automateyournetwork/netclaw --skill pyats-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, pyats, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured, step-by-step methodology to diagnose and resolve common network issues, reducing Mean Time To Resolution (MTTR).

Core Features & Use Cases

  • OSI-Layer Troubleshooting: Follows a logical progression from Layer 1 to Layer 4+ to pinpoint connectivity problems.
  • Protocol Adjacency Diagnosis: Offers specific checklists for OSPF and BGP neighbor issues.
  • Performance & Flapping Analysis: Guides through checking device resources, interface utilization, and logs for performance degradation and interface flapping.
  • Source-of-Truth Reconciliation: Integrates with NetBox to compare device state against documented configurations.
  • Multi-Hop Parallel Collection: Enables simultaneous data gathering from multiple devices for faster analysis of complex paths.
  • Use Case: A user reports that a critical application is unreachable. This Skill can systematically check physical links, ARP, IP routing, ACLs, and routing protocol adjacencies across the affected path to identify the root cause.

Quick Start

Use the pyats-troubleshoot skill to diagnose connectivity loss between R1 and R4.

Frequently Asked Questions about pyats-troubleshoot

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

FAQPage Schema
How do I systematically troubleshoot network connectivity and routing issues?

To systematically troubleshoot network connectivity and routing issues, apply a structured OSI-layer and divide-and-conquer methodology to check physical links, ARP, IP routing, and ACLs across affected device paths, which reduces Mean Time To Resolution.

Can I use pyATS to diagnose OSPF and BGP neighbor adjacency problems?

Yes, you can use pyATS to diagnose OSPF and BGP neighbor adjacencies by following a specific troubleshooting checklist that evaluates protocol states across multiple network devices to pinpoint where the neighbor relationships are failing.

What is the best way to analyze interface flapping and network performance degradation?

Analyzing interface flapping and network performance degradation is best done by checking device resources, interface utilization counters, and system logs to identify the root cause of the physical or protocol instability.

Does pyATS integrate with NetBox for network configuration validation?

Yes, pyATS integrates with NetBox to validate network configurations by comparing live device state against documented source-of-truth data, ensuring actual network behavior matches your intended design baseline.

Do I need Python 3 to run multi-hop parallel state collection for network diagnosis?

Yes, you need Python 3 and pyATS installed to run multi-hop parallel state collection, which enables simultaneous data gathering across multiple devices for faster analysis of complex network paths.