Agent Skills

Agent Skills are portable instruction packages built around a SKILL.md file. BitRouter ships a Skill that teaches a shell-capable agent how to install, configure, migrate to, and troubleshoot the router.

Install the BitRouter Skill

Use your agent host's plugin or skill mechanism. With the generic Skills CLI:

npx skills add bitrouter/bitrouter

Then ask the host to use the BitRouter Skill—for example, “Set up BitRouter for this project.” The Skill explains the commands; the host still owns user approval and process execution.

Inspect installed skills

BitRouter can validate the skills already present on disk:

bro skills list
bro skills list --global

The project-local command checks conventional skill layouts under the current project. --global checks the global Claude-compatible skill root. Each result includes the declared name, description, paths, validity, and a problem when the skill does not satisfy the Agent Skills format.

BitRouter reads these directories; it does not install into them. Installation and activation remain the responsibility of the agent host.

Scaffold a skill

Create a starter skill in the current project:

bro skills init my-skill
bro skills init my-skill --output ./skills/my-skill/SKILL.md

The name must use lowercase ASCII letters, digits, and single internal hyphens. The command refuses to overwrite an existing SKILL.md.