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

1.6 KiB

Raw Blame History

description

description
Interactive setup wizard for cmdb-assistant plugin

CMDB Assistant Setup Wizard

Configure the cmdb-assistant plugin with NetBox integration.

Skills to Load

skills/visual-header.md

Important Context

Uses Bash, Read, Write, AskUserQuestion tools - NOT MCP tools
MCP tools unavailable until after setup + session restart

Usage

/initial-setup

Instructions

Execute skills/visual-header.md with context "Setup Wizard".

Phase 1: Environment Validation

python3 --version

If below 3.10, stop and inform user.

Phase 2: MCP Server Setup

Locate NetBox MCP server in marketplace
Check virtual environment exists
Create venv if missing: python3 -m venv .venv && pip install -r requirements.txt

Phase 3: System Configuration

Create config directory: mkdir -p ~/.config/claude
Check ~/.config/claude/netbox.env exists
If missing, ask user for NetBox API URL (must include /api)
Create config file with placeholder token
Instruct user to add API token manually

Phase 4: Validation

Test API connection if token was added
Report result (200=success, 403=invalid token)
Display completion summary
Remind user to restart session for MCP tools

Completion Summary

CMDB-ASSISTANT SETUP COMPLETE
MCP Server (NetBox):   Ready
System Config:         ~/.config/claude/netbox.env

Restart your Claude Code session for MCP tools.

After restart, try:
- /cmdb-device <hostname>
- /cmdb-ip <address>
- /cmdb-site <name>
- /cmdb-search <query>

User Request

$ARGUMENTS

1.6 KiB Raw Blame History