9routerx — Claude Code skill: what it does, how to install
Claude Code skill connects your agent to the 9RouterX gateway. It routes OpenAI-compatible REST calls for chat, speech, embeddings, and web fetch to multiple AI models.
MIT ★ 259 updated 2026-11-16
npx skills add yanstd888/9routerx --skill 9routerx -a claude-codeWhat 9routerx does
The skill links coding agents to a local or remote 9RouterX gateway. The agent routes requests through unified /v1/... REST endpoints for text generation, speech synthesis, and web search without individual provider boilerplate.
Setup requires defining 9ROUTERX_URL and passing 9ROUTERX_KEY when authentication is enabled. Connectivity is confirmed via /api/health. The skill also indexes modular capability files, prompting the agent to fetch the appropriate SKILL.md when specific tools like image generation or URL fetching are invoked.
What it helps with
- route requests across multiple AI providers through one gateway
- query model endpoints for speech, embeddings, and vision
- pull capability instructions on demand for web search and scraping
Example prompts for the agent
- Configure connection to 9RouterX at http://localhost:20128
- List available text-to-speech models using 9routerx
- Fetch the web-fetch capability skill for 9RouterX
How to install 9routerx
1Skills CLI (Vercel)
npx skills add yanstd888/9routerx --skill 9routerx -a claude-code2Manually: put the files in place
~/.claude/skills/9routerx/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/9routerx/
1Skills CLI (Vercel)
npx skills add yanstd888/9routerx --skill 9routerx -a codex2Manually: put the files in place
.agents/skills/9routerx/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add yanstd888/9routerx --skill 9routerx -a cursor2Manually: put the files in place
.cursor/skills/9routerx/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install yanstd888/9routerx skills/9routerx2Manually: put the files in place
.github/skills/9routerx/SKILL.md1Skills CLI (Vercel)
npx skills add yanstd888/9routerx --skill 9routerx -a gemini-cli2Platform CLI
gemini skills install https://github.com/yanstd888/9routerx --path skills/9routerxManually: put the files in place
.devin/skills/9routerx/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about 9routerx
How to install 9routerx in Claude Code?
Run npx skills add yanstd888/9routerx --skill 9routerx -a claude-code in your terminal.
What does the 9routerx skill do?
It configures access to the 9RouterX AI gateway, describes endpoints for different model types, and directs agents to specific capability skills.
What is required to run 9routerx?
You need an active 9RouterX gateway address set in 9ROUTERX_URL and a 9ROUTERX_KEY token if authentication is enabled.
Source text
SKILL.md · MIT
---
name: 9routerx
description: Entry point for 9RouterX — local/remote AI gateway with OpenAI-compatible REST for chat, image, TTS, embeddings, web search, web fetch. Use when the user mentions 9RouterX, 9ROUTERX_URL, or wants AI without writing provider boilerplate. This skill covers setup + indexes capability skills; fetch the relevant capability SKILL.md from the URLs below when needed.
---
# 9RouterX
Local/remote AI gateway exposing OpenAI-compatible REST. One key, many providers, auto-fallback.
## Setup
```bash
export 9ROUTERX_URL="http://localhost:20128" # or VPS / tunnel URL
export 9ROUTERX_KEY="sk-..." # from Dashboard → Keys (only if requireApiKey=true)
```
All requests: `${9ROUTERX_URL}/v1/...` with header `Authorization: Bearer ${9ROUTERX_KEY}` (omit if auth disabled).
Verify: `curl $9ROUTERX_URL/api/health` → `{"ok":true}`
## Discover models
```bash
curl $9ROUTERX_URL/v1/models # chat/LLM (default)
curl $9ROUTERX_URL/v1/models/image # image-gen
curl $9ROUTERX_URL/v1/models/tts # text-to-speech
curl $9ROUTERX_URL/v1/models/embedding # embeddings
curl $9ROUTERX_URL/v1/models/web # web search + fetch (entries have `kind` field)
curl $9ROUTERX_URL/v1/models/stt # speech-to-text
curl $9ROUTERX_URL/v1/models/image-to-text # vision
```
Use `data[].id` as `model` field in requests. Combos appear with `owned_by:"combo"`.
Response shape:
```json
{ "object": "list", "data": [
{ "id": "openai/gpt-5", "object": "model", "owned_by": "openai", "created": 1735000000 },
{ "id": "tavily/search", "object": "model", "kind": "webSearch", "owned_by": "tavily", "created": 1735000000 }
]}
```
## Capability skills
When the user needs a specific capability, fetch that skill's `SKILL.md` from its raw URL:
| Capability | Raw URL |
|---|---|
| Chat / code-gen | https://raw.githubusercontent.com/yanstd888/9routerx/refs/heads/main/skills/9routerx-chat/SKILL.md |
| Image generation | https://raw.githubusercontent.com/yanstd888/9routerx/refs/heads/main/skills/9routerx-image/SKILL.md |
| Text-to-speech | https://raw.githubusercontent.com/yanstd888/9routerx/refs/heads/main/skills/9routerx-tts/SKILL.md |
| Speech-to-text | https://raw.githubusercontent.com/yanstd888/9routerx/refs/heads/main/skills/9routerx-stt/SKILL.md |
| Embeddings | https://raw.githubusercontent.com/yanstd888/9routerx/refs/heads/main/skills/9routerx-embeddings/SKILL.md |
| Web search | https://raw.githubusercontent.com/yanstd888/9routerx/refs/heads/main/skills/9routerx-web-search/SKILL.md |
| Web fetch (URL → markdown) | https://raw.githubusercontent.com/yanstd888/9routerx/refs/heads/main/skills/9routerx-web-fetch/SKILL.md |
## Errors
- 401 → set/refresh `9ROUTERX_KEY` (Dashboard → Keys)
- 400 `Invalid model format` → check `model` exists in `/v1/models/<kind>`
- 503 `All accounts unavailable` → wait `retry-after` or add another provider account
© yanstd888 · MIT · yanstd888/9routerx