Claude Visio Diagrams — Development skill for Claude Code

claude-visio-diagrams

Generate **native, editable Microsoft Visio (.vsdx) network diagrams plus a PDF** from a bill of materials, using official Cisco stencils, rack-front images and product photos — with nothing but the Python standard library.

Built as a [Claude Code](https://claude.com/claude-code) skill (`SKILL.md`), but the scripts work on their own.

Why

Customers ask for Visio. draw.io's native VSDX export was removed, and converting draw.io files loses the editable stencil shapes. This project writes the VSDX package directly: masters are copied out of Cisco's own `.vssx` stencils, so the customer opens real, editable Nexus/UCS shapes.

What you get

• scripts/visio_builder.py — stdlib VSDX writer: stencil masters, bitmaps (PNG/JPEG), boxes, text, straight/dashed lines, multiple pages, scaled pages (19" switches on 17×11 paper). Verified to open cleanly in Visio.
• scripts/fabric_layout.py — spec → standard two-page fabric drawing: Physical (spines left/right, one leaf column in the middle, every uplink individually traceable, port labels both ends, L3Out, controllers, OOB, optional N:1 breakout patch panels) and Logical (layer boxes, role columns, legend, design summary), with built-in verification (spine-port accounting, hostname regex, uplink counts, ACI rules).
• scripts/render_pdf.py — stdlib PDF renderer (vector + embedded images), used automatically when LibreOffice is not installed.
• scripts/preview_svg.py — SVG preview + bounding-box overlap report.
• scripts/export.sh — LibreOffice export when available, stdlib fallback.
• reference/design-system.md, reference/interview.md — the design rules and the customer-interview catalogue behind the layouts.
• examples/ — build_fabric_example.py (two-page NX-OS fabric: 2 spines, 12 leaves, Nexus Dashboard, OOB, L3Out), build_pov_example.py (compact single-page PoV view with NPU/DPU management badges), visio_open_bisect.py (test files for "Visio c