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>
156 lines
3.4 KiB
Markdown
156 lines
3.4 KiB
Markdown
# Topology Generation Skill
|
|
|
|
Generate Mermaid diagrams from NetBox data.
|
|
|
|
## Prerequisites
|
|
|
|
Load skill: `mcp-tools-reference`
|
|
|
|
## View: Rack Elevation
|
|
|
|
### Data Collection
|
|
|
|
1. Find rack: `dcim_list_racks name=<name>`
|
|
2. Get devices: `dcim_list_devices rack_id=<id>`
|
|
3. Note for each: `position`, `u_height`, `face`, `name`, `role`
|
|
|
|
### Mermaid Template
|
|
|
|
```mermaid
|
|
graph TB
|
|
subgraph rack["Rack: <rack-name> (U<height>)"]
|
|
direction TB
|
|
u42["U42: empty"]
|
|
u41["U41: empty"]
|
|
u40["U40: server-01 (Server)"]
|
|
u39["U39: server-01 (cont.)"]
|
|
u38["U38: switch-01 (Switch)"]
|
|
end
|
|
```
|
|
|
|
### Rules
|
|
|
|
- Mark top U with device name and role
|
|
- Mark subsequent Us as "(cont.)" for multi-U devices
|
|
- Empty Us show "empty"
|
|
|
|
## View: Network Topology
|
|
|
|
### Data Collection
|
|
|
|
1. List sites: `dcim_list_sites`
|
|
2. List devices: `dcim_list_devices site_id=<id>`
|
|
3. List cables: `dcim_list_cables`
|
|
4. List interfaces: `dcim_list_interfaces device_id=<id>`
|
|
|
|
### Mermaid Template
|
|
|
|
```mermaid
|
|
graph TD
|
|
subgraph site1["Site: Home"]
|
|
router1[("core-router-01<br/>Router")]
|
|
switch1[["dist-switch-01<br/>Switch"]]
|
|
server1["web-server-01<br/>Server"]
|
|
server2["db-server-01<br/>Server"]
|
|
end
|
|
|
|
router1 -->|"eth0 - eth1"| switch1
|
|
switch1 -->|"gi0/1 - eth0"| server1
|
|
switch1 -->|"gi0/2 - eth0"| server2
|
|
```
|
|
|
|
### Node Shapes by Role
|
|
|
|
| Role | Shape | Mermaid Syntax |
|
|
|------|-------|----------------|
|
|
| Router | Cylinder | `[(" ")]` |
|
|
| Switch | Double brackets | `[[ ]]` |
|
|
| Server | Rectangle | `[ ]` |
|
|
| Firewall | Hexagon | `{{ }}` |
|
|
| Other | Rectangle | `[ ]` |
|
|
|
|
### Edge Labels
|
|
|
|
Show interface names: `A-side - B-side`
|
|
|
|
## View: Site Overview
|
|
|
|
### Data Collection
|
|
|
|
1. Get site: `dcim_get_site id=<id>`
|
|
2. List racks: `dcim_list_racks site_id=<id>`
|
|
3. Count devices per rack: `dcim_list_devices rack_id=<id>`
|
|
|
|
### Mermaid Template
|
|
|
|
```mermaid
|
|
graph TB
|
|
subgraph site["Site: Headquarters"]
|
|
subgraph row1["Row 1"]
|
|
rack1["Rack A1<br/>12/42 U used<br/>5 devices"]
|
|
rack2["Rack A2<br/>20/42 U used<br/>8 devices"]
|
|
end
|
|
subgraph row2["Row 2"]
|
|
rack3["Rack B1<br/>8/42 U used<br/>3 devices"]
|
|
end
|
|
end
|
|
```
|
|
|
|
## View: Full Infrastructure
|
|
|
|
### Data Collection
|
|
|
|
1. List regions: `dcim_list_regions`
|
|
2. List sites: `dcim_list_sites`
|
|
3. Count devices: `dcim_list_devices status=active`
|
|
|
|
### Mermaid Template
|
|
|
|
```mermaid
|
|
graph TB
|
|
subgraph region1["Region: Americas"]
|
|
site1["Headquarters<br/>3 racks, 25 devices"]
|
|
site2["Branch Office<br/>1 rack, 5 devices"]
|
|
end
|
|
subgraph region2["Region: Europe"]
|
|
site3["EU Datacenter<br/>10 racks, 100 devices"]
|
|
end
|
|
|
|
site1 -.->|"WAN Link"| site3
|
|
```
|
|
|
|
## Output Format
|
|
|
|
Always provide:
|
|
|
|
1. **Summary** - Brief description of diagram content
|
|
2. **Mermaid Code Block** - The diagram code
|
|
3. **Legend** - Explanation of shapes and colors
|
|
4. **Data Notes** - Any data quality issues
|
|
|
|
### Example Output
|
|
|
|
```markdown
|
|
## Network Topology: Home Site
|
|
|
|
This diagram shows network connections between 4 devices at Home site.
|
|
|
|
```mermaid
|
|
graph TD
|
|
router1[("core-router<br/>Router")]
|
|
switch1[["main-switch<br/>Switch"]]
|
|
server1["homelab-01<br/>Server"]
|
|
|
|
router1 -->|"eth0 - gi0/24"| switch1
|
|
switch1 -->|"gi0/1 - eth0"| server1
|
|
```
|
|
|
|
**Legend:**
|
|
- Cylinder shape: Routers
|
|
- Double brackets: Switches
|
|
- Rectangle: Servers
|
|
|
|
**Data Notes:**
|
|
- 1 device (nas-01) has no cable connections documented
|
|
```
|