netbox-reconcile

Reconcile NetBox source of truth against live network state with pyATS.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

NetBox reconciliation automates comparing intended infrastructure data in NetBox with actual device state to detect drift, missing interfaces, undocumented links, and configuration discrepancies.

Core Features & Use Cases

  • Reconcile NetBox as the authoritative source of truth against live device state using NetBox MCP and pyATS.
  • Detect IP drift, missing interfaces, undocumented links, cable mismatches, VLAN mismatches, and ticket discrepancies in ServiceNow.
  • Use cases include auditing network documentation after changes, validating onboarding, and ensuring NetBox data accuracy for audits.

Quick Start

Run the NetBox reconciliation workflow to compare NetBox intent with live state and generate a discrepancy report.

Frequently Asked Questions about netbox-reconcile

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

FAQPage Schema
How do I detect network configuration drift between NetBox and live devices?

NetBox reconciliation detects network configuration drift by comparing intended infrastructure data in NetBox against live device state collected via pyATS. It identifies IP drift, missing interfaces, and cable mismatches to ensure documentation accuracy.

What is NetBox reconciliation used for in network automation?

NetBox reconciliation validates infrastructure accuracy by comparing authoritative NetBox data against live network state. It is used for auditing network documentation after changes, validating device onboarding, and ensuring data accuracy for compliance audits.

Can I use pyATS to collect live network state for NetBox reconciliation?

Yes, pyATS collects live network state for NetBox reconciliation. The workflow uses pyATS to gather actual device data and compares it against the NetBox API to generate a structured discrepancy report identifying configuration drift.

What types of discrepancies can NetBox reconciliation detect?

NetBox reconciliation detects IP drift, missing interfaces, undocumented links, cable mismatches, VLAN mismatches, and ticket discrepancies in ServiceNow. It applies a structured discrepancy taxonomy to categorize these network state variations.

Does NetBox reconciliation require API access to the live network devices?

NetBox reconciliation requires API access to NetBox and live device state collection via pyATS. This access enables the deterministic workflow to query intended infrastructure configurations and compare them against actual network states.

What is the best way to audit NetBox accuracy after network changes?

The best way to audit NetBox accuracy after network changes is to run a deterministic reconciliation workflow. This compares NetBox intent with live device state collected via pyATS to generate a comprehensive discrepancy report.