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.