network

Resumen general del skill de red

Qué hace el skill de red

El skill network te ayuda a crear diagramas de topología de red en PlantUML con iconos mxGraph específicos de cada dispositivo, para que puedas modelar diagramas de LAN, WAN, empresa, centro de datos y de marca de fabricante sin tener que adivinar la sintaxis. Es la opción adecuada cuando necesitas un network skill para diagramas de infraestructura que se vean operativos, no abstractos.

Quién debería usarlo

Usa este skill si documentas routers, switches, firewalls, servidores, acceso inalámbrico, DMZ, sedes remotas o enlaces híbridos y quieres un diagrama que comunique una topología real. Es especialmente útil para equipos que comparan diseños, revisan cambios o generan diagramas para documentación de arquitectura.

Qué lo hace diferente

El valor principal de network está en la fidelidad de los iconos y en las convenciones conscientes de la topología: nombres de stencils de mxGraph, agrupación por zonas, tipos de enlace y pautas de auto-disposición. Eso hace que el resultado sea más específico que un prompt genérico y ayuda a evitar los fallos habituales de los diagramas desordenados, las familias de iconos equivocadas o los esquemas UML de estilo software.

Cómo usar el skill de red

Instala e inspecciona los archivos correctos

Instálalo con npx skills add markdown-viewer/skills --skill network. Después, lee primero SKILL.md y luego los archivos de ejemplo en examples/ como lan-topology.md, enterprise-network.md, datacenter-network.md y hybrid-cloud.md. Estos ejemplos muestran los patrones prácticos de network usage mucho más rápido que revisar todo el repositorio.

Convierte una idea vaga en un prompt útil

Las buenas entradas nombran la topología, las zonas, los dispositivos y los tipos de enlace. Por ejemplo: “Create a branch office network with Internet, firewall, core switch, two access switches, 12 workstations, Wi‑Fi APs, and a site-to-site VPN to HQ. Use Cisco icons and show the DMZ separately.” Esto es mejor que “draw my network” porque el skill necesita alcance y estructura para elegir las familias de stencils correctas.

Sigue las reglas del diagrama que sí importan

La network guide espera PlantUML con @startuml y @enduml, además del fence correcto: usa plantuml o puml, nunca texto plano. Usa -- para enlaces físicos, .. para rutas inalámbricas o de respaldo, y agrupa áreas con rectangle o package. Si necesitas formas de nube o de Internet, modélalas explícitamente en lugar de dejarlas implícitas.

Lee los ejemplos en el orden que coincide con tu trabajo

Si no sabes qué conjunto de stencils encaja mejor, empieza por examples/lan-topology.md para redes generales, examples/cisco-network.md para entornos muy orientados a Cisco, examples/enterprise-network.md para diseños corporativos por capas y examples/security-architecture.md para patrones de defensa en profundidad. Ese recorrido suele darte suficiente información para escribir un primer prompt mejor para el skill network que una revisión rápida del repositorio.

Preguntas frecuentes sobre el skill de red

¿El skill de red es solo para diagramas Cisco?

No. Cisco está bien soportado, pero el skill network también cubre diseños genéricos de LAN/WAN, Citrix, centro de datos, inalámbrico y diagramas de red centrados en seguridad. Elige la familia de stencils que mejor encaje con tu entorno en lugar de forzarlo todo a un único estilo de fabricante.

¿Cuándo no debería usar network?

No lo uses para arquitectura de software general, diagramas de clases o diagramas de servicios en la nube cuando la topología sea principalmente lógica y no basada en dispositivos. Si tu objetivo es el flujo de una aplicación, usa un skill orientado a UML; si tu objetivo es la arquitectura de servicios cloud, usa mejor un skill centrado en nube.

¿Es mejor que escribir PlantUML directamente?

Por lo general sí, porque el skill acota el vocabulario de stencils, la semántica de las conexiones y los patrones de agrupación que son fáciles de equivocarse en un prompt aislado. Un prompt simple puede funcionar en casos sencillos, pero el network skill es más fiable cuando necesitas iconos consistentes y una topología que se lea como un diagrama de infraestructura.

¿Qué debo preparar antes de usarlo?

Ten a mano las zonas de la red, los tipos de dispositivo, el número de sedes, el estilo de fabricante preferido y el comportamiento de los enlaces. Si puedes nombrar elementos concretos como “DMZ”, “core”, “access”, “VPN” o “wireless”, el resultado suele ser más preciso y más rápido de afinar.

Cómo mejorar el skill de red

Da hechos de topología, no solo un tema

El mejor resultado de network install llega con detalles concretos de topología: número de sedes, subredes o zonas principales, roles de dispositivo y qué enlaces son físicos frente a lógicos. “Retail WAN with HQ, 4 branches, firewall at each branch, and VPN backhaul” produce una salida mejor que “enterprise network diagram”.

Indica la familia de iconos y el objetivo

Si quieres Cisco 19, Cisco SAFE, Citrix o iconos de red genéricos, dilo desde el principio. También conviene aclarar si el diagrama es para operaciones, documentación o revisión de arquitectura, porque eso cambia cuánto detalle debe conservar o simplificar el skill network.

Vigila dos fallos comunes

El primero es sobrecargar un solo diagrama con demasiados extremos; soluciónalo pidiendo agrupación por niveles o subdiagramas separados. El segundo es la semántica poco clara de los enlaces; corrígelo indicando qué conexiones son Ethernet, inalámbricas, VPN, de gestión o de flujo de tráfico para que el skill pueda elegir correctamente --, .. o -->.

Itera desde el primer borrador

Después de la primera salida, mejora el diagrama pidiendo zonas que falten, etiquetas más claras o menos tipos de dispositivo por clúster. Si el resultado parece genérico, añade restricciones como “show DMZ and internal VLANs separately,” “use vendor-specific icons,” o “emphasize WAN failover paths,” y el skill network normalmente generará una revisión más útil para tomar decisiones.