CLI & Agent Skill
Agent Skill
Letting Claude Code and other coding agents manage Multi-Router through the CLI.
The Multi-Router skill teaches a coding agent, such as Claude Code, how to use mr: which command does what, how to read its output, and which commands need your confirmation first. With the skill installed you can ask the agent in plain language, for example "list my routers" or "add Claude Sonnet as a fallback on the support router", and it runs the commands for you.
The skill ships inside the CLI, so the skill you install always matches your CLI version. Install the CLI and add a profile first (see Installing the CLI).
Claude Code
This writes the skill to ~/.claude/skills/multi-router/SKILL.md, where Claude Code finds it in every project. Start a new Claude Code session to load it. To install it for one project only, put it in that project's skills folder:
Other agents
mr skill show prints the skill. Save it wherever your agent reads instructions, for example a skills folder or an AGENTS.md file:
What the agent does
| Action | Behaviour |
|---|---|
| Reading | Lists and reads configuration freely, using the default profile unless you name another. |
| Changing | Reads the current state first, then sends only the fields you asked to change. |
| Deleting and disabling | Shows you the target and asks for confirmation before deleting or revoking anything, and before disabling unless you asked for it directly. |
| API keys | Never asks for, reads or prints an API key. If no profile exists, it asks you to run mr profile add yourself. |
Updating
Run mr skill install again after updating the CLI. It reports whether the skill was installed, updated or already current.