lmiranda
747a2b15e5
- 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>
75 lines
1.6 KiB
Markdown
75 lines
1.6 KiB
Markdown
---
|
|
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
|
|
|
|
```bash
|
|
python3 --version
|
|
```
|
|
If below 3.10, stop and inform user.
|
|
|
|
### Phase 2: MCP Server Setup
|
|
|
|
1. Locate NetBox MCP server in marketplace
|
|
2. Check virtual environment exists
|
|
3. Create venv if missing: `python3 -m venv .venv && pip install -r requirements.txt`
|
|
|
|
### Phase 3: System Configuration
|
|
|
|
1. Create config directory: `mkdir -p ~/.config/claude`
|
|
2. Check `~/.config/claude/netbox.env` exists
|
|
3. If missing, ask user for NetBox API URL (must include `/api`)
|
|
4. Create config file with placeholder token
|
|
5. Instruct user to add API token manually
|
|
|
|
### Phase 4: Validation
|
|
|
|
1. Test API connection if token was added
|
|
2. Report result (200=success, 403=invalid token)
|
|
3. Display completion summary
|
|
4. 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
|