Habilidades routeros-command-tree
📦

routeros-command-tree

Seguro

Generar Esquemas de API RouterOS desde el Árbol de Comandos

Construir herramientas que interactúan con RouterOS requiere comprender la jerarquía de comandos. Esta habilidad proporciona el conocimiento para explorar programáticamente el árbol de comandos de RouterOS a través de la API /console/inspect y generar esquemas RAML u OpenAPI.

Soporta: Claude Codex Code(CC)
📊 71 Adecuado
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "routeros-command-tree". What are the child nodes under /system/script?

Resultado esperado:

The /system/script path contains these commands:
- run (cmd) - Execute a script
- add (cmd) - Create a new script
- remove (cmd) - Delete a script
- set (cmd) - Modify script properties
- print (cmd) - List scripts
- export (cmd) - Export script source

Usando "routeros-command-tree". How do I map the /ip/address CLI commands to REST API?

Resultado esperado:

CLI to REST mapping:
- add → PUT /rest/ip/address (creates new entry)
- set → PATCH /rest/ip/address/{id} (updates existing)
- remove → DELETE /rest/ip/address/{id} (deletes entry)
- print → GET /rest/ip/address (lists all)
- get (single) → GET /rest/ip/address/{id}

Auditoría de seguridad

Seguro
v2 • 4/16/2026

All 138 static findings are false positives. The skill is a documentation file containing markdown with code examples. The static scanner incorrectly flagged markdown syntax (backticks for code formatting), documentation code snippets (fetch examples), relative markdown links, and misinterpreted documentation text as security issues. No executable code exists in this skill.

1
Archivos escaneados
329
Líneas analizadas
0
hallazgos
2
Auditorías totales
No se encontraron problemas de seguridad

Patrones detectados

Markdown Code Formatting Misidentified as Command ExecutionDocumentation Code Examples Misidentified as Network CallsMarkdown Links Misidentified as Path Traversal
Auditado por: claude Ver historial de auditorías →

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
32
Comunidad
100
Seguridad
91
Cumplimiento de la especificación

Lo que puedes crear

Construir Herramientas de Documentación de API

Generar documentación de API completa desde el árbol de comandos de RouterOS en vivo para tu versión específica de RouterOS.

Crear Plantillas de Generación de Código

Usar el árbol de comandos para generar bibliotecas de cliente tipadas o proveedores de Terraform para recursos de RouterOS.

Explorar Comandos Disponibles

Descubrir todas las opciones de configuración disponibles y sus parámetros para un conjunto específico de características de RouterOS.

Prueba estos prompts

Exploración Básica del Árbol de Comandos 
What are the available commands under /ip/firewall in RouterOS?
Mapeo de Endpoints de API 
Map the /interface/bridge commands to their corresponding REST API endpoints and HTTP verbs.
Descubrimiento de Argumentos 
What arguments does the /ip/route/add command accept? Show me the syntax for each.
Generación de Esquemas 
Generate an OpenAPI 3.0 schema for the /queue/simple resource based on the RouterOS command tree.

Mejores prácticas

  • Usar la variable de entorno INSPECTFILE para pruebas y evitar consultas repetidas al router en vivo durante el desarrollo
  • Omitir búsquedas de sintaxis para argumentos dentro de subárboles peligrosos (where, do, else, rule, command, on-error) para prevenir fallos del servidor REST
  • Guardar en caché inspect.json por versión de RouterOS ya que el árbol de comandos varía significativamente entre versiones

Evitar

  • No consultar descripciones de sintaxis para cada argumento en un router en vivo - esto toma horas para el recorrido completo del árbol
  • No ignorar rutas peligrosas - llamar a fetchSyntax en nodos arg de esos subárboles termina el proceso del servidor HTTP
  • No asumir que el árbol es idéntico entre versiones de RouterOS - siempre regenerar esquemas para tu versión objetivo

Preguntas frecuentes

¿Qué es /console/inspect en RouterOS?
Es un endpoint de API REST que expone la jerarquía de comandos de RouterOS. Puedes consultarlo para listar hijos de cualquier ruta u obtener texto de ayuda para comandos y argumentos.
¿Cómo evito hacer fallar el servidor REST de RouterOS?
Omitir búsquedas de sintaxis para argumentos dentro de subárboles que contienen: where, do, else, rule, command, on-error. Estos son constructos de scripting que hacen fallar la API inspect cuando se consultan sus nodos arg.
¿Puedo trabajar sin un dispositivo RouterOS en vivo?
Sí. Establece la variable de entorno INSPECTFILE para que apunte a un archivo inspect.json en caché. Herramientas como rest2raml soportan esto para generación de esquemas sin conexión.
¿Cuál es la diferencia entre la salida RAML y OpenAPI?
Ambos representan los mismos datos del árbol de comandos. RAML 1.0 usa notación orientada a recursos. OpenAPI 3.0 usa terminología REST estándar con rutas, métodos y cuerpos de solicitud.
¿Por qué PUT crea entradas en lugar de PUT actualizar?
La API REST de RouterOS usa PUT para operaciones de creación. PATCH se usa para actualizaciones. Esto es lo opuesto a las convenciones REST estándar donde PUT es actualización idempotente y POST es creación.
¿Cuánto tiempo toma el recorrido completo del árbol?
Contra un router en vivo, el recorrido completo toma muchos minutos debido a miles de solicitudes HTTP secuenciales. Con CHR acelerado por KVM es más rápido pero aún consume tiempo. Usar inspect.json en caché para desarrollo.

Detalles del desarrollador

Autor

tikoci

Licencia

MIT

Repositorio

https://github.com/tikoci/routeros-skills/tree/main/routeros-command-tree

Ref.

main

Estructura de archivos

📄 SKILL.md