# Infrahub Common

> 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.

- Skill: `opsmill/infrahub-common-2` (Agent Skill, multi-file: 20 files)
- Install (CLI): `npx skillmds@latest add opsmill/infrahub-common-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/opsmill/infrahub-common-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: opsmill (https://skillmd.com/u/opsmill)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/opsmill/infrahub-common-2

---


# 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
- **`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
- **`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
  - Recovery from partial repository syncs
  - Generated file protocol conventions
  - Information-source priority (skill content before
    external docs)

