Documentation Index Fetch the complete documentation index at: https://mintlify.com/phodal/routa/llms.txt
Use this file to discover all available pages before exploring further.
Overview The routa skill command manages skills — pre-packaged capabilities that agents can use to extend their functionality. Skills are compatible with the OpenCode skill system.
Usage Commands List Skills List all discovered skills in the system:
Example Output: { "jsonrpc" : "2.0" , "id" : 1 , "result" : { "skills" : [ { "name" : "playwright" , "version" : "1.0.0" , "description" : "Browser automation and testing with Playwright" , "path" : "/home/user/.routa/skills/playwright" , "entrypoint" : "skill.json" }, { "name" : "figma-export" , "version" : "0.2.1" , "description" : "Export Figma designs to code" , "path" : "/home/user/.routa/skills/figma-export" , "entrypoint" : "skill.json" } ] } }
Reload Skills Reload skills from disk (useful after adding new skills manually):
Example Output: { "jsonrpc" : "2.0" , "id" : 1 , "result" : { "message" : "Skills reloaded" , "count" : 5 } }
Skill Discovery Routa discovers skills from these locations:
User directory : ~/.routa/skills/Project directory : .routa/skills/Bundled skills : Built-in skills packaged with Routa
Skills are auto-discovered when:
The server starts
You call routa skill reload
An ACP agent spawns (skills are merged into MCP configuration)
Skill Structure A skill is a directory with a skill.json manifest:
~/.routa/skills/ ├── playwright/ │ ├── skill.json # Skill manifest │ ├── index.js # Implementation │ └── README.md └── figma-export/ ├── skill.json ├── export.py └── requirements.txt
Example skill.json: { "name" : "playwright" , "version" : "1.0.0" , "description" : "Browser automation and testing" , "author" : "Your Name" , "repository" : "https://github.com/your/skill" , "tools" : [ { "name" : "browser_screenshot" , "description" : "Take a screenshot of a webpage" , "parameters" : { "url" : { "type" : "string" , "description" : "URL to screenshot" } } } ] }
Installing Skills From GitHub Use the REST API to clone skills:
curl -X POST http://localhost:3000/api/skills/clone \ -H "Content-Type: application/json" \ -d '{ "url": "https://github.com/user/my-skill", "workspaceId": "default" }'
Manual Installation
Create skill directory:
mkdir -p ~/.routa/skills/my-skill cd ~/.routa/skills/my-skill
Create skill.json manifest
Reload skills:
Using Skills with Agents Skills are automatically available to ACP agents through MCP:
# Start chat with skill access routa chat --role DEVELOPER --workspace-id default # Skills are merged into the agent's MCP configuration # Agent can discover and use skill tools
Skill Compatibility Routa skills are compatible with:
OpenCode - Full compatibility with OpenCode skill formatClaude Code - Skills exposed as MCP toolsGemini CLI - Skills available via ACP bridge
Common Workflows Discovering Available Skills # List all skills routa skill list # Extract skill names with jq routa skill list | jq -r '.result.skills[].name' # Get skill details routa skill list | jq '.result.skills[] | select(.name == "playwright")'
Creating a Custom Skill # Create skill directory mkdir -p ~/.routa/skills/my-tool cd ~/.routa/skills/my-tool # Create manifest cat > skill.json << EOF { "name": "my-tool", "version": "1.0.0", "description": "My custom tool", "tools": [] } EOF # Reload to discover routa skill reload # Verify routa skill list | grep my-tool
Next Steps
REST API Programmatic skill management
Custom MCP Servers Integrate custom MCP servers alongside skills
ACP Overview Learn how skills integrate with ACP agents
GitHub Workflow Guide Use skills in automated workflows