Infrahub Skills
Infrahub Skills is an open-source AI skills package covering the full Infrahub development lifecycle. Describe what you want to build in plain language, and the skills produce Infrahub resources that follow the platform's conventions: schemas, object data, generators, transforms, checks, and menus, ready to load into a running instance.
When you would reach for it
You are modelling a new domain and the relationship identifiers have to match on both sides. You have a CSV export from the system Infrahub is replacing, and every column needs a home. You inherited a repository and cannot tell which of its files still follow current conventions. A generator runs, produces the wrong objects, and the traceback points at the SDK rather than at your code. An instance stops answering and support wants logs you have not collected before.
Each of those is a skill. The AI reads the one that matches, applies its rules while it writes, and leaves the rest unread. That last part is what keeps the assistant accurate on long sessions: a skill loads its entry point first and pulls in individual rule files only when the task reaches them.
Three ways to work
Direct mode
For well-scoped, single-skill tasks. Describe what you need and the AI matches it to the right skill automatically. Best for adding an attribute, creating a check, populating a batch of objects, or any task that maps to a single skill.
Spec-Driven Development (SDD)
For complex or multi-part builds. The AI reasons through requirements with you first: capturing what needs to be built, validating the approach against Infrahub conventions, and laying out a task plan for review. Nothing is generated until you approve the plan. Best for designing new schema domains, building generator chains, or any task that involves design decisions across multiple skills. See Spec-Driven Development for details.
End-to-end execution
For full lifecycle workflows. The AI generates files, loads them with infrahubctl, validates the result, and iterates if something fails, all in a single session.
Skills included
| Skill | What it does | Skill name |
|---|---|---|
| Schema Manager | Creates, validates, and modifies Infrahub schema YAML from natural language | infrahub-managing-schemas |
| Object Manager | Produces and updates YAML data files for infrastructure objects | infrahub-managing-objects |
| Check Manager | Builds and debugs Python validation checks for proposed change pipelines | infrahub-managing-checks |
| Generator Manager | Creates, modifies, and debugs design-driven generators that auto-create infrastructure objects | infrahub-managing-generators |
| Transform Manager | Builds and debugs Python or Jinja2 transforms for config generation and data export | infrahub-managing-transforms |
| Menu Manager | Designs and restructures custom navigation menus for the Infrahub web UI | infrahub-managing-menus |
| Data Analyzer | Queries and analyzes live Infrahub data via MCP | infrahub-analyzing-data |
| Repo Auditor | Audits a repository against Infrahub best practices | infrahub-auditing-repo |
| Data Importer | Converts CSV/TSV inputs into Infrahub object YAML and loads onto a fresh branch | infrahub-importing-data |
| Diagnostics Collector | Guides infrahub-collect to gather a support bundle when Infrahub is misbehaving, and reviews it before hand-off | infrahub-collecting-diagnostics |
| Issue Reporter | Routes a bug or feature request to the right Infrahub-ecosystem repository and prepares a sanitized draft for your review | infrahub-reporting-issues |
| Skill Gap Reporter | Turns friction with an Infrahub skill into a reviewed issue with a proposed rule change, filed through the Issue Reporter | infrahub-reporting-skill-gaps |
| Concept Tutor | Teaches Infrahub concepts through the learner's own repo and instance, with verified exercises and progress tracking | infrahub-teaching-concepts |
| Diagnostics Analyzer | Turns a collected diagnostic bundle into a triage report, correlating errors into incidents and matching them against known Infrahub issues | infrahub-analyzing-diagnostics |
| NetBox Device Type Converter | Converts NetBox device-type and module-type definitions into Infrahub Object Templates via a mapping-profile-driven converter | infrahub-converting-netbox-device-types |
A shared reference library (infrahub-common) provides GraphQL query syntax, .infrahub.yml configuration format, YAML structure conventions, and the Profiles vs Object Templates distinction to all skills.
Compatibility
Infrahub Skills works with any AI tool that supports the Agent Skills format or reads custom context files from the project directory. Agents with plugin support get auto-detection and direct invocation; everything else activates passively from project context.
The full matrix and the per-tool setup are in Installation and setup.
Next steps
- Install it: Installation and setup
- Build something in ten minutes: Your first schema
- Find the right skill for a job: Which skill do I use?
- Plan a complex build: Spec-Driven Development
- Understand how skills load: How it works
- Help improve the skills: Anatomy of a skill