netbox-reconcile

Reconcile NetBox source of truth against live network state using pyATS and NetBox API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, NETBOX_MCP_SCRIPT, PYATS_TESTBED_PATH, PYATS_MCP_SCRIPT, SERVICENOW_MCP_SCRIPT, MARKMAP_MCP_SCRIPT, GAIT_MCP_SCRIPT, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures your network documentation in NetBox accurately reflects the live state of your network devices, preventing configuration drift and ensuring data integrity.

Core Features & Use Cases

  • Discrepancy Detection: Identifies differences between NetBox data (IPs, interfaces, cables, VLANs) and actual device configurations.
  • Automated Ticketing: Creates incidents in ServiceNow for critical and high-severity discrepancies.
  • Use Case: Automatically verify that all active interfaces and their IP addresses documented in NetBox are present and correctly configured on your Cisco routers and switches, and generate tickets for any deviations.

Quick Start

Reconcile the NetBox source of truth against the live state of the R1 device.

Frequently Asked Questions about netbox-reconcile

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

FAQPage Schema
How do I reconcile NetBox source of truth against live network state?

NetBox discrepancies are detected by comparing live pyATS device data against the NetBox source of truth to identify undocumented links, cable mismatches, and VLAN inconsistencies across your network infrastructure.

Can I automatically create ServiceNow incidents for network configuration drift?

You can automatically create ServiceNow incidents for network configuration drift by utilizing the automated ticketing feature, which generates tickets specifically for critical and high-severity discrepancies found during the NetBox reconciliation process.

Does this network reconciliation tool work with pyATS and ServiceNow?

Yes, this network reconciliation tool works with pyATS for live network data collection and ServiceNow for incident ticketing, requiring specific MCP scripts and a configured pyATS testbed path to execute successfully.

What types of discrepancies can I detect between NetBox and live devices?

You can detect IP drift, missing interfaces, undocumented links, cable mismatches, VLAN mismatches, and ticket discrepancies in ServiceNow by comparing the NetBox source of truth against live network state using pyATS.

Do I need specific MCP scripts to run NetBox reconciliation?

Yes, you need specific MCP scripts for NetBox, pyATS, ServiceNow, Markmap, and Gait, along with a defined pyATS testbed path and Python3 installed to run the network reconciliation process effectively.

What is the best way to verify NetBox documentation matches live Cisco routers and switches?

The best way to verify NetBox documentation matches live Cisco routers and switches is to automate reconciliation using pyATS for live data collection, checking active interfaces and IPs against the NetBox source of truth to identify deviations.