routeros-command-tree
Gerar Esquemas de API RouterOS a partir da Árvore de Comandos
A construção de ferramentas que interagem com o RouterOS requer compreensão da hierarquia de comandos. Esta skill fornece o conhecimento para explorar programaticamente a árvore de comandos do RouterOS através da API /console/inspect e gerar esquemas RAML ou OpenAPI.
Baixar o ZIP da skill
Upload no Claude
Vá em Configurações → Capacidades → Skills → Upload skill
Ative e comece a usar
Testar
A utilizar "routeros-command-tree". Quais são os nós filhos sob /system/script?
Resultado esperado:
O caminho /system/script contém estes comandos:
- run (cmd) - Executa um script
- add (cmd) - Cria um novo script
- remove (cmd) - Exclui um script
- set (cmd) - Modifica propriedades do script
- print (cmd) - Lista scripts
- export (cmd) - Exporta código-fonte do script
A utilizar "routeros-command-tree". Como mapeio os comandos da CLI /ip/address para a API REST?
Resultado esperado:
Mapeamento CLI para REST:
- add → PUT /rest/ip/address (cria nova entrada)
- set → PATCH /rest/ip/address/{id} (atualiza existente)
- remove → DELETE /rest/ip/address/{id} (exclui entrada)
- print → GET /rest/ip/address (lista todas)
- get (único) → GET /rest/ip/address/{id}
Auditoria de Segurança
SeguroAll 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.
Padrões Detectados
Pontuação de qualidade
O Que Você Pode Construir
Construir Ferramentas de Documentação de API
Gere documentação abrangente de API a partir da árvore de comandos ao vivo do RouterOS para sua versão específica do RouterOS.
Criar Modelos de Geração de Código
Use a árvore de comandos para gerar bibliotecas de cliente tipadas ou provedores Terraform para recursos RouterOS.
Explorar Comandos Disponíveis
Descubra todas as opções de configuração disponíveis e seus parâmetros para um conjunto específico de recursos do RouterOS.
Tente Estes Prompts
Quais são os comandos disponíveis sob /ip/firewall no RouterOS?
Mapeie os comandos /interface/bridge para seus endpoints e verbos HTTP da API REST correspondentes.
Quais argumentos o comando /ip/route/add aceita? Mostre a sintaxe de cada um.
Gere um esquema OpenAPI 3.0 para o recurso /queue/simple com base na árvore de comandos do RouterOS.
Melhores Práticas
- Use a variável de ambiente INSPECTFILE para testes e evitar consultas repetidas ao roteador em tempo real durante o desenvolvimento
- Ignore buscas de sintaxe para argumentos dentro de subárvores perigosas (where, do, else, rule, command, on-error) para evitar falhas no servidor REST
- Mantenha o inspect.json em cache por versão do RouterOS, pois a árvore de comandos varia significativamente entre lançamentos
Evitar
- Não consulte descrições de sintaxe para cada argumento em um roteador em tempo real - isso leva horas para o percurso completo da árvore
- Não ignore caminhos perigosos - chamar fetchSyntax em nós arg dessas subárvores termina o processo do servidor HTTP
- Não presuma que a árvore é idêntica entre versões do RouterOS - sempre regenere esquemas para sua versão alvo