Template

Files

lmiranda 747a2b15e5 refactor(cmdb-assistant): extract skills and slim commands

- Extract 9 skill files from command knowledge:
  - mcp-tools-reference.md: Complete NetBox MCP tools reference
  - system-discovery.md: Bash commands for system info gathering
  - device-registration.md: Device registration workflow
  - sync-workflow.md: Machine sync process
  - audit-workflow.md: Data quality audit checks
  - ip-management.md: IP/prefix management and conflict detection
  - topology-generation.md: Mermaid diagram generation
  - change-audit.md: NetBox change audit workflow
  - visual-header.md: Standard visual header pattern

- Slim all 11 commands to under 60 lines:
  - cmdb-sync.md: 348 -> 57 lines
  - cmdb-register.md: 334 -> 51 lines
  - ip-conflicts.md: 238 -> 58 lines
  - cmdb-audit.md: 207 -> 58 lines
  - cmdb-topology.md: 194 -> 54 lines
  - initial-setup.md: 176 -> 74 lines
  - change-audit.md: 175 -> 57 lines
  - cmdb-site.md: 68 -> 50 lines
  - cmdb-ip.md: 65 -> 52 lines
  - cmdb-device.md: 64 -> 55 lines
  - cmdb-search.md: 46 lines (unchanged)

- Update agent to reference skills for best practices
- Preserve existing netbox-patterns skill

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-30 17:21:21 -05:00

4.1 KiB

Raw Blame History

Device Registration Skill

How to register devices into NetBox.

Prerequisites

Load these skills:

system-discovery - Bash commands for gathering system info
netbox-patterns - Best practices for data quality
mcp-tools-reference - MCP tool reference

Registration Workflow

Phase 1: System Discovery

Use commands from system-discovery skill to gather:

Hostname, OS, hardware model, serial number
CPU, memory, disk
Network interfaces with IPs
Running Docker containers

Phase 2: Pre-Registration Checks

Check if device exists:
```
dcim_list_devices name=<hostname>
```
If exists, suggest /cmdb-sync instead.
Verify/Create site:
```
dcim_list_sites name=<site-name>
```
If not found, list available sites or offer to create.
Verify/Create platform:
```
dcim_list_platforms name=<platform-name>
```
Create if not exists with dcim_create_platform.

Verify/Create device role:

dcim_list_device_roles name=<role-name>

Phase 3: Device Creation

Get/Create manufacturer and device type:

dcim_list_manufacturers name="<manufacturer>"
dcim_list_device_types manufacturer_id=X model="<model>"

Create device:

dcim_create_device
  name=<hostname>
  device_type=<device_type_id>
  role=<role_id>
  site=<site_id>
  platform=<platform_id>
  tenant=<tenant_id>  # if provided
  serial=<serial>
  description="Registered via cmdb-assistant"

Create interfaces: For each network interface:

dcim_create_interface
  device=<device_id>
  name=<interface_name>
  type=<type>
  mac_address=<mac>
  enabled=true

Create IP addresses: For each IP:

ipam_create_ip_address
  address=<ip/prefix>
  assigned_object_type="dcim.interface"
  assigned_object_id=<interface_id>
  status="active"

Set primary IP:

dcim_update_device
  id=<device_id>
  primary_ip4=<primary_ip_id>

Phase 4: Container Registration (if Docker)

Create/Get cluster type:

virt_list_cluster_types name="Docker Compose"
virt_create_cluster_type name="Docker Compose" slug="docker-compose"

Create cluster:

virt_create_cluster
  name=<project-name>
  type=<cluster_type_id>
  site=<site_id>
  description="Docker Compose stack on <hostname>"

Create VMs for containers: For each running container:

virt_create_vm
  name=<container_name>
  cluster=<cluster_id>
  site=<site_id>
  role=<role_id>
  status="active"
  vcpus=<cpu_shares>
  memory=<memory_mb>
  disk=<disk_gb>

Phase 5: Documentation

Add journal entry:

extras_create_journal_entry
  assigned_object_type="dcim.device"
  assigned_object_id=<device_id>
  comments="Device registered via /cmdb-register command\n\nDiscovered:\n- X network interfaces\n- Y IP addresses\n- Z Docker containers"

Summary Report Template

## Machine Registration Complete

### Device Created
- **Name:** <hostname>
- **Site:** <site>
- **Platform:** <platform>
- **Role:** <role>
- **ID:** <device_id>
- **URL:** https://netbox.example.com/dcim/devices/<id>/

### Network Interfaces
| Interface | Type | MAC | IP Address |
|-----------|------|-----|------------|
| eth0 | 1000base-t | aa:bb:cc:dd:ee:ff | 192.168.1.100/24 |

### Primary IP: 192.168.1.100

### Docker Containers Registered (if applicable)
**Cluster:** <cluster_name> (ID: <cluster_id>)

| Container | Role | vCPUs | Memory | Status |
|-----------|------|-------|--------|--------|
| media_jellyfin | Media Server | 2.0 | 2048MB | Active |

### Next Steps
- Run `/cmdb-sync` periodically to keep data current
- Run `/cmdb-audit` to check data quality
- Add tags for classification

Error Handling

Error	Action
Device already exists	Suggest `/cmdb-sync` or ask to proceed
Site not found	List available sites, offer to create new
Docker not available	Skip container registration, note in summary
Permission denied	Note which operations failed, suggest fixes

4.1 KiB Raw Blame History