v1.1.2 Skill estable para Claude Code

Describe tu red. Recíbela validada.

Pídele a Claude un laboratorio de Packet Tracer, el diseño de un campus o el diagnóstico de una falla. La skill escribe un modelo único de la red, lo valida de L1 a L7 y genera configuraciones, documentación y un diagrama interactivo que nunca se contradicen.

npx skills add whetstone-dev/network-engineering
Leer la documentación
Claude CodeCisco Packet TracerIOS · IOS XE · ASANode ≥ 22.18, sin dependencias
pt-3vlan-roas-dhcp/topology.html
Abrir diagrama ↗
BEGINNER0 errores · 4/4 pruebasRouter 2911 + dos 2960, 3 VLAN + gestión + nativa sin uso, router-on-a-stick, DHCP en el router y SSH.

Es el artefacto real que genera netlab build, no una captura. Arrastra, haz zoom y abre un equipo para ver su configuración.

16comandos netlab
17referencias por tema
7redes de ejemplo validadas
L1–L7validación de la red entera
0dependencias npm
VLAN 1001 · Cómo funciona

Un modelo. Todo lo demás se genera.

La red vive en un archivo *.net.json. Diagrama, configuraciones, tablas y pruebas salen de ese mismo modelo validado, así el diagrama nunca contradice a la configuración.

requisitos

Lo describes

“3 VLAN, un router, dos switches, DHCP y SSH”. Claude pregunta solo lo que cambia el diseño y declara los supuestos.

fuente de verdad

Modelo de red

redes/lab.net.json con equipos, puertos exactos, VLAN, direccionamiento VLSM, routing y pruebas esperadas.

netlab validate

Validación

Trunks y nativa, gateways, solapes, DHCP, OSPF/EIGRP, STP, HSRP, ACL, NAT, VPN… y pings simulados de ida y vuelta.

netlab build
topology.htmldiagrama
configs/*.txtIOS · ASA
README.mddocs
analysis.jsondiagnóstico

¿Algo cambia? Se edita el modelo y se regenera. Nunca se parchean salidas a mano.

VLAN 2002 · Ejemplos de uso

Pídelo como se lo pedirías a un ingeniero.

La skill se activa sola con cualquier tarea de redes, o la invocas con /network-engineering. Elige una petición:

claude — ~/networks
Necesito un laboratorio de Packet Tracer con 3 VLAN, un router, dos switches y DHCP.

network-engineering flujo de diseño
  Topología   1 × 2911 (router-on-a-stick) · 2 × 2960
  VLAN       10 VENTAS · 20 ADMIN · 30 TI · 99 gestión · 999 nativa sin uso
  Modelo     redes/lab-3vlan.net.json

$ netlab validate redes/lab-3vlan.net.json
OK    ping PC1 → PC3 (expected success): Round trip OK
OK    ping PC1 → PC2 (expected success): Round trip OK
OK    ping PC5 → 192.168.99.11 (expected success): Round trip OK
OK    ping PC4 → 192.168.20.1 (expected success): Round trip OK
Summary: 0 errors, 0 warnings, 7 notes · 8 devices, 7 links

$ netlab build redes/lab-3vlan.net.json -o salida/lab
  topology.html   interactive diagram
  README.md       documentation (inventory, IP, VLANs, ports, routing, configs, verification)
  configs/        8 candidate files (redacted previews)
  topology.mmd    Mermaid · analysis.json  diagnostics and tables
Validation: 0 errors, 0 warnings, 7 notes · tests 4/4 OK
Respuesta resumida · las salidas de netlab son reales (en inglés), ejecutadas sobre los ejemplos del repositorio
VLAN 3003 · Qué incluye

Razona sobre la red completa, no sobre comandos sueltos.

Valida la red entera

Detecta lo que rompe un laboratorio antes de pegar un solo comando: VLAN no permitida en el trunk, nativa distinta, gateway fuera de la subred, DHCP sin servidor, adyacencias que no se forman, root de STP desalineado con HSRP.

L1L2L3L4L5L6L7

Diagrama en un solo HTML

Inspector por equipo con su config, vista física y L3, filtro por VLAN, caminos de ping resaltados y exportación SVG/PNG. Abre sin internet.

Configuraciones candidatas validadas

Cisco IOS / IOS XE y ASA por equipo, generadas solo cuando la red pasa la validación. Las contraseñas salen redactadas por defecto; pasos de GUI para PCs y servidores de Packet Tracer.

! R1 — cisco 2911 (IOS) interface GigabitEthernet0/0.10 encapsulation dot1Q 10 ip address 192.168.10.1 255.255.255.0 ip dhcp pool SALES default-router 192.168.10.1

No inventa comandos

Marca qué funciona dónde, separa laboratorio de producción y rotula como ilustrativa cualquier salida show de ejemplo.

[PT] Packet Tracer[IOS][XE] IOS XE[HW] hardware real

Modo educativo

PASO 1…N con qué hacemos, por qué, comandos, resultado esperado y error común.

BEGINNERINTERMEDIATEADVANCED

Importa y compara

De show running-config + show cdp neighbors a modelo, sin importar secretos. diff entre versiones con diagrama de cambios.

Analiza capturas

Lee capturas de Packet Tracer, diagramas y salidas show separando hechos de suposiciones.

CONFIRMADOR1 Gi0/0 en trunk
INFERIDOVLAN 20 = ADMIN
DESCONOCIDOmáscara de PC4
VLAN 4004 · Toolkit netlab

También funciona sin Claude.

El mismo CLI que usa la skill. TypeScript ejecutado de forma nativa por Node ≥ 22.18: sin npm install, sin build.

Diseñar

Del modelo a todo lo demás.

  • initModelo base con autocompletado (JSON Schema)
  • validateQuality gate: chequeos L1–L7 + pings simulados; --strict para producción
  • buildDiagrama, docs, configs, Mermaid, análisis
  • configCLI por equipo validada y redactada: IOS, IOS XE o ASA
  • render · docs · mermaidCada salida por separado

Simular

Antes de tocar el equipo.

  • tracePing ida/vuelta con LPM, ACL, NAT, HSRP, ASA e IPsec
  • routesTablas con AD y métrica reales; --ipv6 con OSPFv3
  • catalogModelos de Packet Tracer y sus interfaces

Redes existentes

Documentar y auditar.

  • importshow running-config + CDP → modelo
  • diffAgregados, modificados y eliminados, con diagrama

Calcular

Direccionamiento sin errores.

  • subnetRed, máscara, rango y broadcast
  • vlsmBloque dividido por hosts pedidos
  • ipv6 --splitSubredes IPv6
  • eui64Interfaz IPv6 desde la MAC
node scripts/netlab.ts help
validate sale con código 1 si hay errores: úsalo en CI.Referencia completa de comandos
VLAN 5005 · Instalación

Un comando. Luego, solo pide.

# Instalar con skills.sh
npx skills add whetstone-dev/network-engineering
# Global y sin preguntas, directo para Claude Code
npx skills add whetstone-dev/network-engineering --agent claude-code --global --yes

Actualizar: npx skills update

Instala

Con npx o git clone. Reinicia Claude Code para que detecte la skill.

Describe tu red

Requisitos, una captura de Packet Tracer o tus show running-config.

Recibe la red validada

Diseño, tablas, configs por equipo, verificación y el diagrama en topology.html.

Claude CodeNode.js ≥ 22.18MIT

Tu próximo laboratorio está a un mensaje.

npx skills add whetstone-dev/network-engineering
Ver en GitHub ↗