pyats-topology

Discover multi-vendor network topology from CDP/LLDP, ARP, and routing peer data.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically aggregates CDP/LLDP neighbor data, ARP tables, and routing peers to build an accurate network topology map, enabling fast visualization and documentation of device connections.

Core Features & Use Cases

  • CDP/LLDP neighbor discovery across multi-vendor devices
  • ARP-based interface mapping and adjacency data
  • Topology modeling with VRF, routing peers, and FHRP context
  • Diagram-ready outputs and NetBox reconciliation for source-of-truth alignment

Quick Start

Run the topology discovery workflow across your devices to generate a unified topology model.

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 and map network topology across multi-vendor devices?

Automatically discover network topology by collecting CDP and LLDP neighbor data, ARP tables, and routing peers to build a comprehensive adjacency map of multi-vendor device connections. This creates a unified topology model for visualization and documentation tasks.

What is the best way to build a network topology model that includes VRF and routing peer context?

Build a network topology model with VRF, routing peer, and FHRP context by aggregating CDP/LLDP neighbor discovery and ARP data. This approach captures logical routing structures alongside physical adjacencies to provide a complete representation of network links.

Can I use pyats to collect CDP and LLDP data for network topology visualization?

Yes, you can use pyats to collect CDP and LLDP data for topology visualization. It requires an MCP script environment and a defined testbed path to gather neighbor information and generate diagram-ready representations of your network links.

How do I generate diagram-ready network topology outputs from ARP and routing peer data?

Generate diagram-ready topology outputs by aggregating ARP-based interface mappings and routing peers into a structured topology model. This process transforms raw discovery data into adjacency maps suitable for documentation and visualization.

Does network topology discovery support reconciliation with NetBox as a source of truth?

Yes, network topology discovery supports NetBox reconciliation for source-of-truth alignment. It compares discovered CDP/LLDP and ARP adjacency data against existing NetBox records to ensure your documentation accurately reflects the live network state.