mcpField
I
infrahub-common

infrahub-common

github.com/opsmillCloud & DevOps27164 installsUpdated 1d ago
Repository

About infrahub-common

infrahub-common is a shared reference collection for other Infrahub skills and is not intended for direct invocation. It gathers query syntax, configuration details, Marketplace guidance, migration notes, and cross-skill practices.

Key features

  1. 01Infrahub GraphQL query reference
  2. 02`.infrahub.yml` configuration field guide
  3. 03Marketplace discovery and reuse guidance
  4. 04NetBox migration comparison reference
  5. 05Metadata and template documentation
  6. 06Shared practices and troubleshooting guidance

Use cases

  1. 01Look up shared rules for other Infrahub skills
  2. 02Build and validate GraphQL queries
  3. 03Reuse Marketplace schemas and collections
  4. 04Migrate NetBox queries or templates

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/opsmill/infrahub-skills --skill infrahub-common

After installing, type/infrahub-commonin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

graphql-queries.md
infrahub-yml-reference.md
marketplace-reference.md
metadata-lineage.md
netbox-vs-infrahub.md
profiles-and-templates.md
rules/
_sections.md
_template.md
caching-display-label.md
connectivity-python-environment.md
connectivity-server-check.md
deployment-git-integration.md
deployment-gql-dry-run.md
deployment-partial-sync-recovery.md
protocols-adopt-typed-kinds.md
protocols-generated.md
testing-resource-framework.md
workflow-branch-for-crud.md
workflow-information-priority.md

Details

From the project README

Infrahub Common References

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
    • schema.graphql as infrahubctl graphql export-schema output — re-exported, never hand-edited
    • 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)

Comments

Markdown supported