Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add yanstd888/9routerx --skill 9routerx -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/9routerx/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/9routerx/

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

Similar skills

All skills for AI and ML →

From the same set9

9routerx-embeddings The 9routerx-embeddings Claude Code skill creates text embeddings through the 9RouterX API. The agent uses it for RAG, semantic search, and text similarity tasks. CX Codex +1 ★ 259repo stars 9routerx-chat The 9routerx-chat Claude Code skill sends language-model requests through 9RouterX. It activates for code generation, text summaries, and other prompts to a model. CX Codex +1 ★ 259repo stars 9routerx-tts The 9routerx-tts Claude Code skill turns text into speech through the 9RouterX API. It runs for voiceovers, generated audio, or reading text aloud. CX Codex +1 ★ 259repo stars 9routerx-image The 9routerx-image Claude Code skill creates images through the 9RouterX API. It activates when a request asks for a picture or text-to-image generation. CX Codex +1 ★ 259repo stars 9routerx-stt 9routerx-stt — a skill for Claude Code and Codex that routes audio transcription requests through 9RouterX. Transcribes voice recordings and generates subtitle files across multiple model backends. CX Codex +1 ★ 259repo stars 9routerx-web-fetch The 9routerx-web-fetch Claude Code skill retrieves webpage content as Markdown, plain text, or HTML. The agent uses it to read an article or extract material from a URL. CX Codex +1 ★ 259repo stars 9routerx-video The 9routerx-video Claude Code skill creates videos through xAI Grok Imagine. It runs when asked to generate a clip from text or an image. CX Codex +1 ★ 259repo stars 9routerx-web-search The 9routerx-web-search Claude Code skill searches the web and public X posts through 9RouterX. It runs when an agent is asked to find articles, information, or posts on X. CX Codex +1 ★ 259repo stars

Project sponsors

Companies that keep this analytics open