Infrahub Common References

SkillDev tools

Shared references and cross-cutting rules for all Infrahub skills — GraphQL syntax, .infrahub.yml format, and common patterns. DO NOT TRIGGER directly — loaded automatically by other Infrahub skills when they need shared references.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Infrahub Common References skill

What this skill tells your AI

The instructions your AI receives, as published by opsmill/infrahub-skills in skills/infrahub-common/SKILL.md and read by ahel’s review.

This skill contains shared resources referenced by all other Infrahub skills. It is not meant to be invoked directly.

Contents

  • graphql-queries.md — Infrahub GraphQL query syntax, filters, nested queries, and pagination patterns
  • infrahub-yml-reference.md.infrahub.yml configuration file format and field reference
  • marketplace-reference.md — Infrahub Marketplace: reusing published schemas and collections via infrahubctl marketplace get, discovery with infrahubctl marketplace list / search / show, and airgap fallback. Reuse before modelling from scratch.
  • netbox-vs-infrahub.md — Field-by-field migration appendix for engineers porting NetBox queries, templates, or overlay data
  • metadata-lineage.md — Value metadata (source, owner, is_protected): what each field means, how to set it in object files, and why source does not control edit access
  • profiles-and-templates.md — The Profiles vs Object Templates distinction and mechanics
  • rules/ — Cross-cutting rules shared across skills:
    • Branch-first data CRUD (default to a branch, not the default branch)
    • Caching display labels in queries
    • Python environment and connectivity checks
    • Git integration and deployment patterns
    • Dry-running a changed .gql query against the live schema before merge, and which infrahubctl command does it for a transform, check or generator
    • Recovery from partial repository syncs
    • Generated file protocol conventions
    • Adopting generated protocols for typed SDK calls
    • Information-source priority (skill content first, with a concrete last-resort procedure for consulting docs.infrahub.app on a genuine gap)

Signals

GitHub stars
26
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
infrahub-common
Source
github.com/opsmill/infrahub-skills