source-of-truth-audit

Reconcile NetBox or Nautobot inventory against live network discovery data.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/vahagn-madatyan/netsec-skills-suite --skill source-of-truth-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: source-of-truth-audit
Source: https://github.com/vahagn-madatyan/netsec-skills-suite/tree/main/skills/source-of-truth-audit
Command: npx skills add https://github.com/vahagn-madatyan/netsec-skills-suite --skill source-of-truth-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Reconciliation of authoritative SOT records (NetBox or Nautobot) with live network discovery data to surface gaps and data-quality issues that can impede automation, governance, and accurate reporting.

Core Features & Use Cases

  • SOT Inventory Extraction: Pulls device, interface, IP, VLAN, and topology data from the SOT platform to establish an authoritative baseline.
  • Live Discovery & Diffing: Collects live network state (SNMP/CLI/CDP/LLDP) and compares it against the SOT baseline to identify mismatches and undocumented assets.
  • Gap Classification & Data Quality: Categorizes differences into actionable gap types and computes a composite health score to guide remediation.
  • Reconciliation Reporting: Generates an executive-ready report with a gap inventory, remediation priorities, and trend-ready metrics.

Quick Start

Provide a reconciliation snapshot by performing SOT extraction, running live discovery, and generating the remediation report.

Frequently Asked Questions about source-of-truth-audit

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

FAQPage Schema
How do I reconcile NetBox inventory against live network discovery data?

Reconcile NetBox inventory by extracting SOT baseline data and comparing it against live SNMP, CLI, CDP, and LLDP discovery to identify undocumented assets and mismatches. The process outputs structured diffs and a data-quality score to guide remediation.

What is network source-of-truth auditing and when do I need it?

Network source-of-truth auditing compares authoritative SOT records from platforms like Nautobot against live network state to surface gaps. You need it when data-quality issues impede automation, governance, or accurate reporting across multi-vendor environments.

Does source-of-truth auditing work for multi-vendor environments with Nautobot?

Yes, source-of-truth auditing applies to multi-vendor environments using Nautobot. It requires SOT access and live discovery credentials to audit device inventories, interface topology, IP allocations, VLAN mappings, and cabling across diverse hardware.

What's the best way to classify data-quality gaps in network inventory?

The best way to classify data-quality gaps is to perform a diff analysis between SOT records and live discovery data. This categorizes differences into actionable gap types and computes a composite health score to prioritize remediation efforts.

Can I audit VLAN mappings and IP allocations using diff analysis?

Yes, you can audit VLAN mappings and IP allocations by running diff analysis between SOT extracted data and live network state. The audit covers device inventories, interface topology, and cabling to ensure accurate records.

What do I need to generate a network reconciliation report?

To generate a network reconciliation report, you need SOT platform access and live discovery credentials. The process extracts the SOT baseline, collects live state, and outputs an executive-ready report with gap inventory and remediation priorities.