pyats-topology

Discover and map network topology using CDP, LLDP, ARP, and routing protocols.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the discovery and mapping of your network's physical and logical topology, eliminating the need for manual diagramming and ensuring documentation accuracy.

Core Features & Use Cases

  • Multi-protocol Discovery: Leverages CDP, LLDP, ARP, and routing protocols (OSPF, BGP, EIGRP) to gather network connectivity data.
  • Topology Visualization: Builds a comprehensive network map including devices, interfaces, IP addresses, and subnet information.
  • Source-of-Truth Reconciliation: Compares discovered topology against NetBox data to identify undocumented or missing links.
  • Use Case: When onboarding a new network engineer, provide them with an accurate, up-to-date network diagram generated by this Skill, drastically reducing their learning curve.

Quick Start

Use the pyats-topology skill to discover CDP neighbors on device R1.

Frequently Asked Questions about pyats-topology

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

FAQPage Schema
How do I automatically discover network topology using CDP and LLDP?

Automate network topology discovery by leveraging PyATS to collect CDP and LLDP neighbor data across devices. This process builds a comprehensive physical network map, eliminating manual diagramming and ensuring documentation accuracy.

Can I reconcile discovered network topology data with NetBox?

Yes, you can reconcile discovered network topology with NetBox. This Skill compares collected device connectivity data against your NetBox source-of-truth to identify undocumented or missing links in your network documentation.

What is the best way to map network connectivity using ARP and routing protocols?

Mapping network connectivity is best achieved by collecting ARP and routing protocol neighbor information like OSPF and BGP. This captures logical topology details including IP addresses and subnets to generate accurate network diagrams.

Do I need PyATS and Python 3 to map my network topology?

Yes, PyATS and Python 3 are required dependencies for executing network topology mapping. You must also configure environment variables like PYATS_TESTBED_PATH to define your device testbed before running discovery.

Why use automated discovery for network visualization and documentation?

Automated discovery for network visualization ensures documentation accuracy by dynamically gathering CDP and LLDP data. It drastically reduces the learning curve for new engineers by providing up-to-date network diagrams over manual diagramming.