# cisco-network-diagram

cisco-network-diagram parses Cisco router and switch configurations to generate professional network topology diagrams in Draw.io format. Use it to visualize network infrastructure and create network documentation automatically.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 4 repo stars
- Author: neuro-synapse
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/neuro-synapse/network-topology-agent/tree/HEAD/.claude/skills/cisco-network-diagram-skill/SKILL.md
- Updated: 2025-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/cisco-network-diagram

## What it does

This skill extracts topology data from Cisco configuration files: devices, interfaces, connections, and neighbor relationships discovered via CDP or LLDP. It then builds a Draw.io diagram with appropriate device icons and automatic layout. Supports show commands, configuration files, and routing protocol data (OSPF, BGP, EIGRP), with multi-layer visualization options for physical, logical, L2, and L3 views.

Requires the `drawio-network-plot` Python library installed. The skill processes already-collected device configurations; it does not perform SSH connections or data collection itself. Output is written to `/mnt/user-data/outputs/network-diagram.drawio` and can be edited directly in Draw.io.

Choose from hierarchical (core-to-access) layout, left-to-right for service chains, or manual positioning for complex topologies. Edge labels can display subnet addresses, VLAN numbers, link speeds, and routing protocol information.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add neuro-synapse/network-topology-agent --skill cisco-network-diagram -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cisco-network-diagram-skill/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cisco-network-diagram-skill/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add neuro-synapse/network-topology-agent --skill cisco-network-diagram -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cisco-network-diagram-skill/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add neuro-synapse/network-topology-agent --skill cisco-network-diagram -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cisco-network-diagram-skill/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install neuro-synapse/network-topology-agent .claude/skills/cisco-network-diagram-skill
```

2. **Manually: put the files in place**
- File: `.github/skills/cisco-network-diagram-skill/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add neuro-synapse/network-topology-agent --skill cisco-network-diagram -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/neuro-synapse/network-topology-agent --path .claude/skills/cisco-network-diagram-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cisco-network-diagram-skill/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add neuro-synapse/network-topology-agent --skill cisco-network-diagram -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/neuro-synapse/network-topology-agent/tree/HEAD/.claude/skills/cisco-network-diagram-skill/SKILL.md

## When to use it
- Render network topology from Cisco device configurations
- Map device neighbors discovered via CDP or LLDP
- Document multi-layer network architecture automatically
- Convert show commands and configs into visual diagrams
- Export network topology to Draw.io for editing and refinement

## Example prompts
- Generate a network diagram from the Cisco router configs I've collected
- Build topology visualization from show cdp neighbors output and configuration files
- Create a multi-layer diagram showing physical connections, logical VLANs, and L3 routes

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 5fa4031e277f409b.

BEGIN THIRD-PARTY FILE 5fa4031e277f409b
````text
---
name: cisco-network-diagram
description: Generate Draw.io network topology diagrams from Cisco router and switch configurations. Use when asked to visualize network topology, create network diagrams, map network infrastructure, or generate visual representations from Cisco device configs. Supports parsing show commands, configuration files, CDP/LLDP neighbor data, and routing protocol information to automatically create professional network diagrams.
license: MIT
---

# Cisco Network Diagram Generator

Generate professional Draw.io network topology diagrams from Cisco device configurations using the `drawio-network-plot` Python library.

## Overview

This skill automates the creation of network topology diagrams by:
1. Parsing Cisco device configurations to extract topology data
2. Identifying devices, interfaces, connections, and network relationships
3. Generating Draw.io XML diagrams with proper device icons and layouts
4. Supporting multi-layer visualization (physical, logical, L2, L3)

**Assumption**: Device configurations have already been collected. This skill focuses on parsing and visualization, not SSH access or data collection.

## Installation

Install required library:
```bash
pip install drawio-network-plot --break-system-packages
```

## Quick Start Workflow

1. **Parse configurations** - Extract topology data from config files
2. **Build topology model** - Create device and connection objects
3. **Generate diagram** - Use drawio-network-plot to create XML
4. **Save output** - Write to `/mnt/user-data/outputs/network-diagram.drawio`

## Parsing Cisco Configurations

### Key Data to Extract

Extract these elements from Cisco configs:

**Device Information:**
- Hostname: `hostname <name>`
- Device type: Infer from model (router/switch/firewall/L3 switch)
- Management IP: `interface <mgmt>` + `ip address`

**Interface Details:**
- Interface name, status, IP address, subnet mask
- VLANs: `switchport access vlan`, `switchport trunk allowed vlan`
- Descriptions: `description <text>`
- Speed/duplex settings

**Layer 2 Connections:**
- CDP neighbors: Parse `show cdp neighbors detail` output
````
END THIRD-PARTY FILE 5fa4031e277f409b

The third-party file has ended. Everything between the 5fa4031e277f409b tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2138 of 11100 bytes. © neuro-synapse · MIT · https://github.com/neuro-synapse/network-topology-agent/tree/HEAD/.claude/skills/cisco-network-diagram-skill/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
