infrahub-analyzing-data

Queries and correlates live Infrahub infrastructure data via the MCP server to answer operational questions.

9|2|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/opsmill/infrahub-solution-ai-dc --skill infrahub-analyzing-data-opsmill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: infrahub-analyzing-data
Source: https://github.com/opsmill/infrahub-solution-ai-dc/tree/main/.agents/skills/infrahub-analyzing-data
Command: npx skills add https://github.com/opsmill/infrahub-solution-ai-dc --skill infrahub-analyzing-data-opsmill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Answering operational questions about network infrastructure—compliance gaps, change impact, drift between design and reality—normally requires manual cross-referencing across many systems. This Skill queries a live Infrahub instance through its MCP server, correlates data across node types, and produces actionable findings with remediation hints. ## Core Features & Use Cases - Interactive Data Analysis: Uses Infrahub MCP tools (get_nodes, search_nodes, query_graphql) to fetch, filter, and traverse infrastructure data on demand. - Compliance & Drift Detection: Checks naming conventions, VLAN assignments, BGP session symmetry, IP space usage, and design-to-reality mismatches. - Impact Investigation: Traces blast radius of changes—maintenance windows, prefix modifications, service dependencies—before execution. - Use Case: Ask "Which services depend on devices in the PAR01 maintenance window?" and receive a report listing affected BGP sessions, services, and customers with remediation recommendations. ## Quick Start Invoke the skill with your infrastructure question as the argument, for example: /infrahub:analyzing-data Which devices have no platform assigned?

Frequently Asked Questions about infrahub-analyzing-data

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

FAQPage Schema
How do I query Infrahub infrastructure data with the MCP server?▼

Use mcp__infrahub__get_nodes with a kind and filters for typed reads, or mcp__infrahub__query_graphql for relationship traversal and aggregation. Discover available kinds and valid filter keys first with mcp__infrahub__get_schema or the infrahub://schema resource.

How do I detect drift between design and realized devices in Infrahub?▼

Query the topology design nodes and the realized DcimDevice objects separately, then diff the two sets by name or ID. Missing devices appear in the design set only, extra devices appear in reality only, and attribute mismatches are flagged per object.

When should I use MCP analysis instead of an InfrahubCheck?▼

Use MCP analysis for one-off questions, exploration, and informal policies. Use an InfrahubCheck when a stable policy must be enforced automatically on every proposed change, and a Transform when you need recurring scheduled reports exported as artifacts.

Can the Infrahub MCP server write changes to the default branch?▼

No. All writes via node_upsert, node_delete, and mutate_graphql land on an auto-created mcp/session-* branch. Changes reach the default branch only after propose_changes opens a Proposed Change that a human reviews and merges.

Why does my Infrahub GraphQL query return empty edges?▼

Empty edges usually mean a wrong kind name, a missing edges/node wrapper level, or a case-sensitive filter value mismatch. Verify the kind with get_schema, confirm each relationship level has its edges/node envelope, and retry without filters to confirm data exists.

What happens if I invoke infrahub-analyzing-data without arguments?▼

The skill runs in a forked context with no visibility into the parent conversation, so it cannot infer your question. Without arguments it returns an error asking you to re-invoke with the question passed as args.