Agent skill

Embeddings via 9Router

by decolua in decolua/9router

Generates vector embeddings through the 9Router /v1/embeddings endpoint, using models from providers such as OpenAI, Gemini, Mistral and Voyage for RAG and semantic search.

MITAuto-check passedAI & LLM Engineering

Install Embeddings via 9Router

skills CLI
$ npx skills add decolua/9router --skill 9router-embeddings -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install decolua/9router 9router-embeddings --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/decolua/9router.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/9router-embeddings .claude/skills/9router-embeddings && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
9router-embeddings
GitHub stars
30k
Token cost
~604 tokens
SKILL.md length
95 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Generates vector embeddings through the 9Router /v1/embeddings endpoint, using models from providers such as OpenAI, Gemini, Mistral and Voyage for RAG and semantic search.

  • Embedding text for RAG or semantic search through 9Router
  • SKILL.md covers Discover, Endpoint, Examples and Response shape, plus 1 more section
  • Calls curl and jq; needs NINEROUTER_KEY
  • Listing the embedding models a 9Router instance offers

What it does

The skill needs `NINEROUTER_URL`, plus `NINEROUTER_KEY` when authentication is enabled. Embedding models are discovered at `/v1/models/embedding`, and per-model dimensions at `/v1/models/info`. The embeddings call is a POST to `/v1/embeddings` with a required `model` and `input`, which can be one string or an array, an optional `encoding_format` of `float` or `base64`, and `dimensions`, which works only on OpenAI v3 models. Examples are given in curl and JavaScript, and the response follows the OpenAI list shape with one embedding per input.

A provider table lists quirks: OpenAI, OpenRouter, Mistral, Voyage, Fireworks, Together, Nebius, GitHub, NVIDIA and Jina use the native OpenAI shape, Gemini requests are converted on the server to its embed calls, and OpenAI-compatible or custom providers take a base URL from stored credentials. Sending an array in one request is faster, though some providers cap the batch size.

When your agent uses it

  • Embedding text for RAG or semantic search through 9Router
  • Listing the embedding models a 9Router instance offers
  • Checking an embedding model's dimensions before building an index
  • Batching many strings into one embeddings request

Example prompts

  • “List the embedding models on my 9Router and show the dimensions of the OpenAI small model.”
  • “Embed these three product descriptions with 9Router and return the vectors as JSON.”
  • “Write a Node script that batches my FAQ entries into embeddings requests against 9Router.”

Requirements

  • A running 9Router instance with `NINEROUTER_URL` set, and `NINEROUTER_KEY` when authentication is on

What it can do on your machine

Read from SKILL.md and the folder at commit ce4460e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NINEROUTER_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Embeddings via 9Router loads about 604 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 95 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~604

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from decolua/9router at commit ce4460e, republished under its MIT licence (© decolua). 95 words, ~604 tokens.

Download SKILL.mdSave it as .claude/skills/9router-embeddings/SKILL.md (or your agent's skills folder).
name
9router-embeddings
description
Generate vector embeddings via 9Router /v1/embeddings using OpenAI / Gemini / Mistral / Voyage / Nvidia / GitHub embedding models for RAG, semantic search, similarity. Use when the user wants embeddings, vectors, RAG, semantic search, or to embed text.

9Router — Embeddings

Requires NINEROUTER_URL (and NINEROUTER_KEY if auth enabled). See https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router/SKILL.md for setup.

Discover

bash
curl $NINEROUTER_URL/v1/models/embedding | jq '.data[].id'
# Per-model dimensions
curl "$NINEROUTER_URL/v1/models/info?id=openai/text-embedding-3-small"

Endpoint

POST $NINEROUTER_URL/v1/embeddings

FieldRequiredNotes
modelyesfrom /v1/models/embedding
inputyesstring OR array of strings
encoding_formatnofloat (default) / base64
dimensionsnoOpenAI v3 only

Examples

bash
curl -X POST $NINEROUTER_URL/v1/embeddings \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/text-embedding-3-small","input":["hello","world"]}'

JS:

js
const r = await fetch(`${process.env.NINEROUTER_URL}/v1/embeddings`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "gemini/text-embedding-004", input: "RAG chunk text" }),
});
const { data } = await r.json();
console.log(data[0].embedding.length);  // dimension

Response shape

json
{ "object": "list", "model": "openai/text-embedding-3-small",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0123, -0.045, ...] },
    { "object": "embedding", "index": 1, "embedding": [...] }
  ],
  "usage": { "prompt_tokens": 5, "total_tokens": 5 } }

Provider quirks

ProviderNotes
openai, openrouter, mistral, voyage-ai, fireworks, together, nebius, github, nvidia, jina-aiNative OpenAI shape — dimensions works only on OpenAI v3 (text-embedding-3-*)
gemini, google_ai_studioServer auto-converts to embedContent/batchEmbedContents — send OpenAI shape
openai-compatible-*, custom-embedding-*Custom baseUrl from credentials

Batch (input as array) is faster; some providers cap batch size.

© decolua, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/9router-embeddings of decolua/9router.

Open the folder on GitHubat commit ce4460e

Compare with similar skills

Embeddings via 9Router next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Embeddings via 9Router compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Embeddings via 9Router this skilldecolua/9router30k—~604Automated safety check: PassMIT
Keiroutermydisha/keirouter147—~995Automated safety check: PassMIT
Using Ccproxy APIstarbaser/ccproxy350—~4kAutomated safety check: PassCustom licence
Using Ccproxy Inspectorstarbaser/ccproxy350—~2.7kAutomated safety check: PassCustom licence
Provider Integrationhex/claude-council851—~635Automated safety check: PassMIT
Keirouter Embeddingsmydisha/keirouter147—~577Automated safety check: PassMIT

Similar skills

  • Keirouter

    mydisha/keirouter

    Entry point for KeiRouter — local/remote AI gateway with OpenAI-compatible REST for chat, image, TTS, embeddings, web search, web fetch.

    147 GitHub stars~995 tokensUpdated 29 days ago
    AI & LLM EngineeringAuto-check passed
  • Using Ccproxy API

    starbaser/ccproxy

    Guides users through ccproxy as an OpenAI-compatible and Anthropic-compatible LLM API server with SDK integration, OAuth authentication, sentinel key substitution, model routing, and troubleshooting.

    350 GitHub stars~4k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed
  • Using Ccproxy Inspector

    starbaser/ccproxy

    Operates the ccproxy inspector MITM system for intercepting, inspecting, and transforming LLM API traffic.

    350 GitHub stars~2.7k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed
  • Provider Integration

    hex/claude-council

    Adds new AI providers to claude-council, configures provider API settings, troubleshoots provider connections, and documents the provider script interface.

    851 GitHub stars~635 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Keirouter Embeddings

    mydisha/keirouter

    Generate vector embeddings via KeiRouter /v1/embeddings using OpenAI / Gemini / Mistral / Voyage / Nvidia embedding models for RAG, semantic search, similarity.

    147 GitHub stars~577 tokensUpdated 29 days ago
    AI & LLM EngineeringAuto-check passed
  • Openrouter Multi Provider

    jeremylongshore/tons-of-skills-marketplace

    Use multiple AI providers (OpenAI, Anthropic, Google, Meta) through OpenRouter's unified API.

    2.8k GitHub stars~2.5k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from decolua/9router

All 9 skills in this repo
  • Sets up access to the 9Router AI gateway, an OpenAI-compatible REST endpoint for chat, images, speech, embeddings, web search and web fetch, and indexes its capability skills.

    30k GitHub stars~744 tokensUpdated yesterday
    Auto-check passed
  • Sends chat and code-generation requests through a 9Router gateway using OpenAI or Anthropic message formats, with streaming and auto-fallback combos.

    30k GitHub stars~635 tokensUpdated yesterday
    Auto-check passed
  • Generates images through a 9Router gateway's image endpoint, with model discovery, the request fields and per-provider quirks for OpenAI, Gemini, MiniMax and others.

    30k GitHub stars~830 tokensUpdated yesterday
    Auto-check passed
  • 9Router Speech-to-Text

    decolua/9router

    Transcribes audio files into text or subtitles through 9Router's Whisper-compatible endpoint, using models from OpenAI, Groq, Gemini, Deepgram and others.

    30k GitHub stars~914 tokensUpdated yesterday
    Auto-check passed
  • 9Router Text to Speech

    decolua/9router

    Turns text into spoken audio through a 9Router server, choosing among voices from OpenAI, ElevenLabs, Deepgram, Edge TTS and other providers.

    30k GitHub stars~765 tokensUpdated yesterday
    Auto-check passed
  • Submits text-to-video or image-to-video jobs to xAI Grok Imagine through 9Router, then polls the job and downloads the finished MP4.

    30k GitHub stars~992 tokensUpdated yesterday
    Auto-check passed

Questions about Embeddings via 9Router

What does Embeddings via 9Router do?

Generates vector embeddings through the 9Router /v1/embeddings endpoint, using models from providers such as OpenAI, Gemini, Mistral and Voyage for RAG and semantic search. The skill needs `NINEROUTER_URL`, plus `NINEROUTER_KEY` when authentication is enabled. Embedding models are discovered at `/v1/models/embedding`, and per-model dimensions at `/v1/models/info`.

When should I use Embeddings via 9Router?

Embeddings via 9Router fits situations like: embedding text for RAG or semantic search through 9Router; listing the embedding models a 9Router instance offers; checking an embedding model's dimensions before building an index; batching many strings into one embeddings request.

How do I install Embeddings via 9Router in Claude Code?

Run `npx skills add decolua/9router --skill 9router-embeddings -a claude-code`. Or copy the skill folder (skills/9router-embeddings in decolua/9router) into .claude/skills/9router-embeddings in your project. Claude Code loads it when a task matches its description.

How do I install Embeddings via 9Router in Codex?

Run `npx skills add decolua/9router --skill 9router-embeddings -a codex`. Or copy the skill folder (skills/9router-embeddings in decolua/9router) into .agents/skills/9router-embeddings in your project. Codex loads it when a task matches its description.

Can I use Embeddings via 9Router in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add decolua/9router --skill 9router-embeddings -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/9router-embeddings, .gemini/skills/9router-embeddings, .github/skills/9router-embeddings and .opencode/skills/9router-embeddings in your project.

What does Embeddings via 9Router need to run?

Going by SKILL.md and its folder, Embeddings via 9Router needs the command-line tools its instructions call (curl and jq) and credentials named NINEROUTER_KEY. Our summary lists: A running 9Router instance with `NINEROUTER_URL` set, and `NINEROUTER_KEY` when authentication is on.

Does Embeddings via 9Router access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Embeddings via 9Router safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Embeddings via 9Router use?

Embeddings via 9Router is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Embeddings via 9Router use?

About 604 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Embeddings via 9Router?

Skills that share tags, products or a category with Embeddings via 9Router: Keirouter (mydisha/keirouter, 147 stars), Using Ccproxy API (starbaser/ccproxy, 350 stars), Using Ccproxy Inspector (starbaser/ccproxy, 350 stars) and Provider Integration (hex/claude-council, 851 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Embeddings via 9Router?

decolua (a GitHub user) maintains it in decolua/9router, which has 30,491 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 8, 2026.

Source: decolua/9router on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.