NetBox Best Practices

Best practices for NetBox API integrations, available for multiple AI coding assistants and human readers.

Quick Start

Audience	Start Here
Engineers	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

npx skills add netboxlabs/netbox-best-practices

Option 2: Manual install

# 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:

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

Rules are auto-applied based on file patterns. See Cursor Rules docs for details.

Available Content

Skills / Rules

Topic	Description
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

For Engineers

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

For Claude Code Users

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

For Cursor IDE Users

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