Skip to content
Back to search

routeros-skills

Custom instruction SKILL.md for MikroTik RouterOS v7

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/tikoci/routeros-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/tikoci/routeros-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tikoci--routeros-skills/badge.svg)](/listings/tikoci--routeros-skills)

HTML

<a href="/listings/tikoci--routeros-skills"><img src="/api/listings/tikoci--routeros-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Clone this repo and symlink the skill folders into your assistant skill directories:

git clone https://github.com/tikoci/routeros-skills.git ~/GitHub/routeros-skills

cd ~/GitHub/routeros-skills
make link   # Copilot, Claude, Codex, and Hermes
make check

Each skill is a folder containing a `SKILL.md` file and optionally a `references/` subfolder. VS Code Copilot and Claude Code automatically discover skills in their respective `~/.*/skills/` directories. Codex discovers user-authored skills in `~/.agents/skills`, and Hermes in `~/.hermes/skills`.

> **Tip:** Start with **routeros-fundamentals** — it covers the core concepts that other skills reference.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 89 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # MikroTik RouterOS "SkillStore" (`SKILL.md`) for AI assistants
  2. [![CI](https://github.com/tikoci/routeros-skills/actions/workflows/ci.yml/badge.svg)](https://github.com/tikoci/routeros-skills/actions/workflows/ci.yml)
  3. Custom instruction skills for [GitHub Copilot](https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot), Claude Code, Codex, and similar AI coding assistants that teach them about [MikroTik RouterOS](https://mikrotik.com/) v7.
  4. ## Skills
  5. Names distinguish RouterOS knowledge from tikoci tooling:
  6. - `routeros-*`: RouterOS features, protocols, and platform knowledge.
  7. - `routeros-tikoci-*`: using public tikoci tools with RouterOS, including centrs
  8. and quickchr. Future tikoci tool skills use this prefix too.
  9. - Bare `tikoci-*`: local project and maintainer skills, outside this repository.
  10. | Skill | Description |
  11. |-------|-------------|
  12. | **routeros-fundamentals** | RouterOS v7 domain knowledge — CLI, REST API, scripting, architecture. The foundational skill that others build on. |
  13. | **routeros-scripting** | RouterOS scripting and CLI config automation — `.rsc` syntax, `[find]` selectors, script-safe IDs, arrays, globals, scheduler policies. |
  14. | **routeros-container** | RouterOS `/container` subsystem — VETH/bridge networking, OCI images, device-mode, lifecycle management. |
  15. | **routeros-firewall** | RouterOS firewall filter, NAT, mangle, and address-list configuration — rule ordering, connection tracking, address/interface lists, DNS redirects, and port forwarding. |
  16. | **routeros-hotspot** | RouterOS hotspot captive portal for wired/wireless access control — hotspot chains, profiles, walled garden, DHCP option 114 (RFC 8910), RADIUS integration. |
  17. | **routeros-app-yaml** | RouterOS `/app` YAML format for container applications (7.21+ builtin, 7.22+ custom YAML). |
  18. | **routeros-command-tree** | `/console/inspect` API — command tree introspection, schema generation, CLI-to-REST mapping. |
  19. | **routeros-syntax-inspection** | `/console/inspect` syntax surfaces (`highlight`/`completion`/`syntax`) + `:parse` IL — validating commands, reading token streams, enum discovery, script "explain"/lint; necessary-not-sufficient vs runtime. |
  20. | **routeros-qemu-chr** | MikroTik CHR (Cloud Hosted Router) with QEMU — boot, VirtIO, acceleration, CI/CD patterns. |
  21. | **routeros-tikoci-quickchr** | Ground RouterOS config/scripts/API code against a real router with quickchr (`@tikoci/quickchr`) — boot a disposable CHR, apply config, read it back; networking recipes, integration-test harness patterns. |
  22. | **routeros-tikoci-quickchr-cli** | The shell-first half of quickchr — boot a disposable CHR from the terminal and drive it with centrs. Lifecycle (`add` is not `start`), `--bg`, endpoints and credentials, L2 links between VMs, and the provisioning steps that only apply before first boot. |
  23. | **routeros-tikoci-centrs** | Drive a real router or CHR with centrs (`@tikoci/centrs`) — target resolution from the WinBox CDB or a quickchr VM, RouterOS command validation before it runs, and one structured envelope over REST, native API, SSH/SFTP, MAC-Telnet, and MNDP. Use instead of hand-rolled `curl`/`ssh`. |
  24. | **routeros-zerotier** | Native ZeroTier on ARM/ARM64 — instances, network authorization, RouterOS controllers, managed routes, firewall integration, RoMON, and bridging. |
  25. | **routeros-webfig** | Link humans to RouterOS WebFig views — connections, addresses, VLANs, bridges, firewall rules and CMR; object URLs, login/session behavior, and native WebView integration guidance grounded on CHR browser checks. |
  26. | **routeros-netinstall** | `netinstall-cli` for automated RouterOS device flashing — etherboot, BOOTP/TFTP, modescript. |
  27. | **routeros-proprietary-protocols** | Navigator for MikroTik-specific protocols and file formats — WinBox/M2, MAC-WinBox, RoMON, MAC-Telnet, MNDP, API, EoIP, btest, IP packing, and binary files; research/implementation pointers and explicit knowledge gaps. |
  28. | **routeros-mndp** | MNDP (MikroTik Neighbor Discovery Protocol) — wire format, `/ip/neighbor`, WinBox discovery. |
  29. | **routeros-mac-telnet** | MAC-Telnet (UDP 20561) — Layer-2 terminal by MAC address, 22-byte header, control blocks, MD5 + MTWEI (EC-SRP) auth. |
  30. | **routeros-sniffer** | RouterOS packet capture and TZSP streaming — `/tool/sniffer`, firewall sniff-tzsp, Wireshark integration. |
  31. ## Install
  32. Clone this repo and symlink the skill folders into your assistant skill directories:
  33. ```sh
  34. git clone https://github.com/tikoci/routeros-skills.git ~/GitHub/routeros-skills
  35. cd ~/GitHub/routeros-skills
  36. make link # Copilot, Claude, Codex, and Hermes
  37. make check
  38. ```
  39. The centrs and quickchr skills were renamed to `routeros-tikoci-*`. Existing
  40. installs should run `make link` after pulling, update explicit skill names and
  41. links, and start a fresh assistant session. See [migration details](SETUP.md#renamed-tikoci-tool-skills).
  42. Each skill is a folder containing a `SKILL.md` file and optionally a `references/` subfolder. VS Code Copilot and Claude Code automatically discover skills in their respective `~/.*/skills/` directories.
  43. Codex discovers user-authored skills in `~/.agents/skills`, and Hermes in `~/.hermes/skills`.
  44. > **Tip:** Start with **routeros-fundamentals** — it covers the core concepts that other skills reference.
  45. ## Repository layout
  46. This repo is the **single source of truth** for all `routeros-*` skills. Locally, `~/.copilot/skills/routeros-*`, `~/.claude/skills/routeros-*`, `~/.agents/skills/routeros-*`, and `~/.hermes/skills/routeros-*` are symlinks into this repo — editing any of those locations is the same as editing here.
  47. Non-`routeros-*` skills (e.g. `tikoci-*`, `screenshot`, `sql-as-rag`) are personal/project-scoped and live only in the local user-level skill directories, **not** in this repo. See [SETUP.md](SETUP.md) for the full local setup guide.
  48. **The Skill Set is the `routeros-*/` folders only.** Everything else at the repo root is the **CI/QA and tooling layer** that validates and ships those skills — it is *not* part of the skill content and is not symlinked into `~/.*/skills/`:
  49. - `.github/` — CI workflows (lint, link check, dependency review), CodeQL Default Setup, and Dependabot config
  50. - `scripts/` — the `SKILL.md` validator (`check-skills.ts`) run by CI and `make lint`
  51. - `hooks/` — optional local git hooks that re-symlink skills after checkout/merge (`make install-hooks`)
  52. - `Makefile`, `.markdownlint*.yaml`, `cspell.json`, `project-words.txt`, `package.json`, `bun.lock` — lint/build configuration and the dev dependency tree
  53. ## Scope
  54. These skills cover **RouterOS 7.x** (long-term and newer releases). RouterOS v6 is not covered and accuracy for v6 questions will be low.
  55. ## Contributing
  56. 1. Fork this repository (or branch, if you have write access)
  57. 2. Edit or add skills (each skill is a `<name>/SKILL.md` folder)
  58. 3. Run the checks locally: `make lint` (and `make lint-links` if you have [lychee](https://lychee.cli.rs/))
  59. 4. Open a pull request — `main` is protected, so all changes land via PR
  60. Every PR is gated by [CI](.github/workflows/ci.yml) (markdownlint + cspell + a `SKILL.md` validator + offline link check) and reviewed by CodeRabbit and Copilot. See [CONTRIBUTING.md](CONTRIBUTING.md) for the local setup, the dictionary policy, and what each check does.
  61. Feedback, corrections, and new skill ideas are welcome via [issues](https://github.com/tikoci/routeros-skills/issues).
  62. ## License
  63. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.