netbox-integration-best-practices

| Audience | Start Here |

|----------|------------|

| Engineers | [HUMAN.md](./HUMAN.md) - Best practices guide |

| Claude Code users | Install skills (see below) |

| Cursor IDE users | Install rules (see below) |

Claude Code Installation

Option 1: npx skills CLI

```bash

npx skills add netboxlabs/netbox-best-practices

```

Option 2: Manual install

```bash

# Global (all projects)

cp -r skills/* ~/.claude/skills/

# Or project-local

cp -r skills/* .claude/skills/

```

Cursor IDE Installation

Copy .cursor/rules/ to your project root:

```bash

cp -r .cursor/rules/ /path/to/your/project/.cursor/rules/

```

Rules are auto-applied based on file patterns. See [Cursor Rules docs](https://cursor.com/docs/context/rules) for details.

Skills / Rules

| Topic | Description |

|-------|-------------|

| [netbox-integration-best-practices](./skills/netbox-integration-best-practices/) | REST/GraphQL API integration patterns |

Content Formats

| Format | Location | Description |

|--------|----------|-------------|

| Human Documentation | HUMAN.md | Concise guide for engineers |

| Claude Code Skills | skills/*/SKILL.md | Progressive disclosure format |

| Cursor Rules | .cursor/rules/*.mdc | Concise IDE rules |

| Detailed Rules | skills/*/references/rules/ | Authoritative source |

[HUMAN.md](./HUMAN.md) provides a concise best practices guide covering all skills. For detailed rationale and exceptions, see the individual rule files in skills/*/references/rules/.

Skills are automatically discovered from the skills/ directory. See [CLAUDE.md](./CLAUDE.md) for maintenance information.

Cursor rules are in the .cursor/rules/ directory and will be automatically applied based on file patterns. See [AGENTS.md](./AGENTS.md) for a quick reference.