routeros-syntax-inspection

Solid

Inspecting and validating RouterOS command/script syntax against a live device via /console/inspect (highlight, completion, syntax, child) and :parse IL. Use when: validating RouterOS commands before execution, explaining or linting RouterOS scripts, building syntax-aware tooling (LSP servers, validators, agent explain/check commands), interpreting highlight token streams or :parse intermediate language, discovering enum values or argument schemas, or when the user mentions console/inspect, highlight tokens, parseIL, or RouterOS script validation.

API & Backend 40 stars 9 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
54
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# RouterOS Syntax Inspection ## Overview RouterOS exposes its **own parser** over the REST API: `/console/inspect` classifies every byte of console input (`highlight`), proposes continuations (`completion`), returns structured help (`syntax`), and enumerates the command tree (`child`); the `:parse` scripting command returns the intermediate language (IL) the engine actually executes. Together these are the ground truth for "is this valid RouterOS?" — version-exact, package-exact, and even runtime-state-exact, which no static grammar can be. This skill is a **probe-selection and wire-format guide**: which surface answers which question, how to read each response, and which claims the responses do and do not support. It is grounded in full-corpus captures (913 scripts × multiple RouterOS versions) published in [tikoci/lsp-routeros-ts](https://github.com/tikoci/lsp-routeros-ts) — the `docs/` references there carry the full evidence [^1]. **"Parse RouterOS" is not one operation.** Pick the probe for the question: | Question | Probe | What it cannot establish | |---|---|---| | Which span is a command, argument, variable, comment, live-state marker? | `request=highlight` | Nested structure; value validity; anything after the first hard error | | Is the script structurally valid; what blocks/expressions result? | `:parse` | Source ranges; partial IL on error; path/argument split without schema data | | What is valid at this cursor position? Enum values? | `request=completion` |...

Details

Author
tikoci
Repository
tikoci/routeros-skills
Created
4 months ago
Last Updated
1 weeks ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category