routeros-skills

Agent skills that teach AI coding agents how to work with MikroTik RouterOS.

Each skill is a folder with a SKILL.md (short, task-oriented instructions) and a references/ folder that holds the
official documentation for that area as plain Markdown. The instructions tell an agent what to do and what to avoid; the
references let it look up the exact command, property or procedure instead of guessing.

The skills use only the portable Agent Skills format: a name and a description in the front matter, then Markdown.
They work with Claude Code, Codex, GitHub Copilot and any other agent that reads SKILL.md folders.

Browse and install the skills on skills.sh.

Status: public. The skills work together with mikrotik-mcp: the agent plans
with the skills and inspects or changes the router through the MCP tools (see Related projects).
With routeros-lsp they are meant to become the knowledge layer of a MikroTik
agent. Changes go through pull requests (see CONTRIBUTING.md).

See it work

A replay of a real session in the Claude desktop app's Code tab, drawn from its transcript. It is not a screen recording,
and the answer is shortened. The skills sit in the project's .claude/skills folder (see Install); the session
lists them, loads the one that fits the task and opens the reference files it needs.

Skills

Start here

Read routeros-fundamentals first; it explains the console conventions and maps the other skills.

Security and access

Interfaces and IP services

Routing, tunnels and redundancy

Wireless, mobile and access networks

Operations and automation

Hardware, storage and apps

How a skill is laid out

skills/<name>/
  SKILL.md        instructions: when to use it, workflow, recipes, pitfalls, where to look
  scripts/        optional shell, PowerShell or Python helpers (only when they add value)
  references/     the documentation for this area
    INDEX.md      what is inside, one line per file (start here)
    guides/       narrative pages of the manual, same path as on manual.mikrotik.com
    cli/          the CLI reference; one file per menu, including its commands
    products/     hardware manuals (routeros-hardware only)
    help/         pages that exist only on help.mikrotik.com

An agent loads only the name and description of every skill, reads SKILL.md when a task matches, and opens a reference
file only when it needs that detail. Keep that in mind when you write or review a skill: SKILL.md should be enough to do
the common task correctly, and the references should be enough to do the rare one.

Install

With the skills CLI (Node 22.20 or newer). This repository is listed on the
skills.sh hub:

npx skills add wiresage/routeros-skills                                   # choose skills and agents interactively
npx skills add wiresage/routeros-skills -s routeros-firewall routeros-vpn # selected skills
npx skills add wiresage/routeros-skills --list                            # only show what is available

The CLI reports each install anonymously to skills.sh; set DISABLE_TELEMETRY=1 to turn that off. How this repository
is published there is described in docs/skills-sh.md.

Skills are plain folders, so installing also means copying or linking them into the place your agent reads skills from.
The installers in this repository do that without Node:

scripts/install-skills.sh --target ~/.claude/skills            # every skill
scripts/install-skills.sh --target .agents/skills routeros-firewall routeros-vpn   # selected skills

scripts/install-skills.ps1 -Target "$HOME\.claude\skills"

Common locations (check your agent's documentation, they change): Claude Code .claude/skills/ or ~/.claude/skills/,
Codex .agents/skills/, GitHub Copilot .github/skills/. Use --link (-Link) to symlink instead of copy so that a
git pull updates the installed skills.

Where the content comes from

The snapshot date and the page counts are in docs-snapshot.json. The crawl, the conversion to
Markdown and the checks that every page arrived complete are part of this repository (see CONTRIBUTING.md),
so the snapshot can be refreshed when MikroTik updates the manual. docs/skill-coverage.md shows how
much of each skill's references its SKILL.md leads an agent to, and docs/manual.lock.json records which manual version the
snapshot was last compared with.

Not included: the manual's blog and its documentation change log (they are not RouterOS documentation), tag listing pages
(they only repeat links), pictures (each reference has a Source: link to the page with the figures), the translations in
the quick guides (the English text is complete), and one help page about exam proctoring. Details are in docs-snapshot.json.

Related projects

• routeros-lsp: language server for RouterOS scripts. Use it to check .rsc files
  before they reach a router.
• mikrotik-mcp: MCP server that lets an agent read and change a real device.
  Load it together with the skills and they work well side by side: the skills tell the agent what a safe RouterOS setup
  looks like and which commands matter, and the MCP tools read the router and apply the change. We tested the two together
  on a lab router (a read-only firewall audit and one reversible change). The MCP has no tools yet for some things the skills
  cover, such as /ip/service and interface lists, so those steps stay manual.

The skills in this repository are written so that they also work when the agent has no live access: they tell it which
commands to propose and how to verify them.

License

The instructions, scripts and tools in this repository are available under the MIT License.
The documentation copied into the references/ folders belongs to MikroTik; see NOTICE.md.

See also AGENTS.md (for agents that work on this repository), CONTRIBUTING.md and
SECURITY.md.