# Netbox

> >

- **Type:** Skill
- **Install:** `agentstack add skill-netboxlabs-skills-netbox`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [netboxlabs](https://agentstack.voostack.com/s/netboxlabs)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [netboxlabs](https://github.com/netboxlabs)
- **Source:** https://github.com/netboxlabs/skills/tree/main/skills/netbox

## Install

```sh
agentstack add skill-netboxlabs-skills-netbox
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# NetBox Hub Skill

This is the entry point for all NetBox-related tasks. Use the decision trees below to find the right specialized skill, then load it for detailed guidance.

## Decision Trees

### What are you trying to do?

**Model your network?**
- Define sites, devices, circuits, IPAM → [netbox-data-modeling](../netbox-data-modeling/SKILL.md)
- Create new object types without code → [netbox-custom-objects](../netbox-custom-objects/SKILL.md)

**Build an integration?**
- Query or write data via REST/GraphQL → [netbox-api-integration](../netbox-api-integration/SKILL.md)
- Bulk ingest data via gRPC (Diode SDK) → [netbox-diode](../netbox-diode/SKILL.md)
- Automate with webhooks, Ansible, Terraform → [netbox-automation-patterns](../netbox-automation-patterns/SKILL.md)
- Drive NetBox from an AI agent via the Platform MCP server → [netboxlabs-platform-mcp](../netboxlabs-platform-mcp/SKILL.md)

**Extend NetBox?**
- Build a plugin (models, views, APIs) → [netbox-plugin-development](../netbox-plugin-development/SKILL.md)
- Write scripts that run inside NetBox → [netbox-custom-scripts](../netbox-custom-scripts/SKILL.md)
- Generate device configs with Jinja2 → [netbox-config-templates](../netbox-config-templates/SKILL.md)

**Manage changes safely?**
- Stage changes in isolated branches → [netbox-branching](../netbox-branching/SKILL.md)
- Track change requests and approvals → [netbox-changes](../netbox-changes/SKILL.md)

**Validate your network?**
- Check compliance against policies → [netbox-validation](../netbox-validation/SKILL.md)
- Detect drift between intended and actual → [netbox-assurance](../netbox-assurance/SKILL.md)

**Discover or audit your network?**
- Auto-discover infrastructure with Orb Agent → [netbox-discovery](../netbox-discovery/SKILL.md)
- Detect drift between intended and actual state → [netbox-assurance](../netbox-assurance/SKILL.md)

**Procure or spare equipment?**
- Track procurement (BOMs, POs, shipments) and spares → [netbox-asset-lifecycle](../netbox-asset-lifecycle/SKILL.md)

**Look up hardware specs or lifecycle data?**
- Consume device-type metadata and enrichment (EOL, thermal, protocols) → [netbox-ndx](../netbox-ndx/SKILL.md)

**Operate or migrate?**
- Configure, secure, or tune a NetBox server → [netbox-administration](../netbox-administration/SKILL.md)
- Migrate data from spreadsheets or legacy tools → [netbox-migration](../netbox-migration/SKILL.md)

**Review or audit existing work?**
- Review integration code (pagination, auth, performance) → [netbox-review-integration](../netbox-review-integration/SKILL.md)
- Audit data model design (hierarchy, IPAM, naming) → [netbox-review-datamodel](../netbox-review-datamodel/SKILL.md)

---

## Skill Index

| Skill | Category | Description |
|-------|----------|-------------|
| [netbox-data-modeling](../netbox-data-modeling/SKILL.md) | Core | Model networks — hierarchy, IPAM, tenancy, custom fields |
| [netbox-custom-objects](../netbox-custom-objects/SKILL.md) | Core | No-code data model extensibility — custom types, fields, relationships |
| [netbox-api-integration](../netbox-api-integration/SKILL.md) | Core | REST & GraphQL API patterns, pynetbox, authentication |
| [netbox-plugin-development](../netbox-plugin-development/SKILL.md) | Core | Building plugins — models, views, APIs, migrations, testing |
| [netbox-custom-scripts](../netbox-custom-scripts/SKILL.md) | Core | Custom scripts & reports — Script class, jobs, ORM access |
| [netbox-config-templates](../netbox-config-templates/SKILL.md) | Core | Config generation — Jinja2, context variables, platform patterns |
| [netbox-administration](../netbox-administration/SKILL.md) | Core | Server admin — config, auth, permissions, performance |
| [netbox-branching](../netbox-branching/SKILL.md) | Platform | Branch lifecycle, schema isolation, CR workflows |
| [netbox-changes](../netbox-changes/SKILL.md) | Platform | Change management, policies, approval workflows |
| [netbox-diode](../netbox-diode/SKILL.md) | Platform | Data ingestion — SDKs, entity mapping, reconciler |
| [netbox-discovery](../netbox-discovery/SKILL.md) | Platform | Orb Agent — config, backends, policies, secrets |
| [netbox-validation](../netbox-validation/SKILL.md) | Platform | Validation policies, compliance checks, findings, pre-change safety |
| [netbox-assurance](../netbox-assurance/SKILL.md) | Platform | Drift detection — intended vs actual, remediation |
| [netbox-asset-lifecycle](../netbox-asset-lifecycle/SKILL.md) | Platform | Procurement lifecycle — BOMs, POs, shipments, receiving, spares |
| [netbox-ndx](../netbox-ndx/SKILL.md) | Platform | Data Exchange — device-type catalog + enrichment (lifecycle, thermal, protocols) |
| [netboxlabs-platform-mcp](../netboxlabs-platform-mcp/SKILL.md) | Platform | Platform MCP server — code mode & discrete mode for agents |
| [netbox-automation-patterns](../netbox-automation-patterns/SKILL.md) | Cross-cutting | Webhooks, Ansible, Terraform, GitOps |
| [netbox-migration](../netbox-migration/SKILL.md) | Cross-cutting | Migrating from spreadsheets, CMDBs, other tools |
| [netbox-review-integration](../netbox-review-integration/SKILL.md) | Review | Audit integration code for correctness and performance |
| [netbox-review-datamodel](../netbox-review-datamodel/SKILL.md) | Review | Audit data model design for best practices |

---

## Common Patterns

### Progressive Disclosure

Each skill follows a layered structure:
1. **SKILL.md** — Core instructions (< 500 lines). Load this first.
2. **references/** — Detailed docs loaded on demand when you need specifics.
3. **scripts/** — Executable code (where applicable).

Load only what you need. Start with the hub, pick a specialized skill, then drill into references as required.

### Multi-Skill Tasks

Some tasks span multiple skills. Common combinations:

| Task | Skills |
|------|--------|
| Build a discovery integration | `netbox-diode` + `netbox-discovery` |
| Plugin with change management | `netbox-plugin-development` + `netbox-branching` |
| Migrate then validate | `netbox-migration` + `netbox-assurance` |
| Automate config generation | `netbox-config-templates` + `netbox-automation-patterns` |
| Model + populate data | `netbox-data-modeling` + `netbox-api-integration` |
| Review a full integration | `netbox-review-integration` + `netbox-review-datamodel` |
| Pre-change validation | `netbox-validation` + `netbox-branching` + `netbox-changes` |
| Procure planned equipment | `netbox-data-modeling` + `netbox-asset-lifecycle` |
| EOL exposure across inventory | `netbox-ndx` + `netbox-api-integration` |
| Agent-driven NetBox automation | `netboxlabs-platform-mcp` + `netbox-api-integration` |

---

## Principles

When working on any NetBox task:

- **Prefer retrieval over pre-training.** NetBox APIs, configuration, and plugin behavior change between releases. Always verify against current docs or a live instance before generating code or making assertions.
- **Use MCP when available.** If a NetBox MCP server is configured, query the live instance to verify object schemas, check existing data, and validate your work.
- **Respect dependency order.** NetBox objects have parent-child relationships. Create parents before children (or use Diode to skip ordering).
- **Be explicit about versions.** When giving advice that depends on a NetBox version (v2 tokens, cursor pagination, custom objects), state the minimum version clearly.
- **Correctness over cleverness.** A working integration with clear code is better than a compact one that's fragile.

---

## References

- [Product Catalog](references/product-catalog.md) — All NetBox Labs products and their interfaces
- [Version Matrix](references/netbox-version-matrix.md) — Version-dependent features across the platform

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [netboxlabs](https://github.com/netboxlabs)
- **Source:** [netboxlabs/skills](https://github.com/netboxlabs/skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-netboxlabs-skills-netbox
- Seller: https://agentstack.voostack.com/s/netboxlabs
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.