Agent skill

Openrouter Embeddings

by QinghongLin in QinghongLin/data2story-skill

Generate text embeddings via OpenRouter using Qwen3-Embedding-8B.

MITAuto-check passedAI & LLM Engineering

Install Openrouter Embeddings

skills CLI
$ npx skills add QinghongLin/data2story-skill --skill openrouter-embeddings -a claude-code

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

GitHub CLI
$ gh skill install QinghongLin/data2story-skill openrouter-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/QinghongLin/data2story-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/data2story/designer/scripts/openrouter-embeddings .claude/skills/openrouter-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
openrouter-embeddings
GitHub stars
155
Token cost
~499 tokens
SKILL.md length
139 words
Files
3 (incl. scripts)
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Generate text embeddings via OpenRouter using Qwen3-Embedding-8B.

  • Tasks that involve Embeddings
  • SKILL.md covers Usage, Flags, Endpoint and Notes
  • Runs Python scripts from its folder; calls python3; needs OPENROUTER_API_KEY
  • Tasks that involve Model routing and gateways

What it does

Openrouter Embeddings is an agent skill from QinghongLin/data2story-skill. Generate text embeddings via OpenRouter using Qwen3-Embedding-8B.

Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `config.json` and `scripts/embed.py`).

It sits in AI & LLM Engineering, covering Embeddings and Model routing and gateways. It works with OpenRouter and Qwen. The repository describes itself as: Data Journalist Agent: Transforming Data into Verifiable Multimodal Story. The licence is MIT.

When your agent uses it

  • Tasks that involve Embeddings
  • Tasks that involve Model routing and gateways

Example prompts

  • “/openrouter-embeddings”

Requirements

  • Python 3
  • A credential in OPENROUTER_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 63a55c1. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

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

    • OPENROUTER_API_KEY

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

Context cost

Openrouter Embeddings loads about 499 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 139 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from QinghongLin/data2story-skill at commit 63a55c1, republished under its MIT licence (© QinghongLin). 139 words, ~499 tokens.

Download SKILL.mdSave it as .claude/skills/openrouter-embeddings/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
openrouter-embeddings
description
Generate text embeddings via OpenRouter using Qwen3-Embedding-8B.

openrouter-embeddings

Text → embedding vector via OpenRouter. Default model: qwen/qwen3-embedding-8b.

Usage

Resolve TOOL_DIR = the directory containing this SKILL.md. Commands below use TOOL_DIR as a symbolic placeholder; replace it with the resolved, quoted path before running Bash.

Single text
bash
export OPENROUTER_API_KEY=sk-or-v1-...

python3 TOOL_DIR/scripts/embed.py \
  --text "The quick brown fox jumps over the lazy dog" \
  --output vec.json
Batch from JSONL

Input records.jsonl (one JSON per line):

{"id": "row_0", "text": "Every place name in the United States."}
{"id": "row_1", "text": "Nearby stars and potential exoplanets."}

Run:

bash
python3 TOOL_DIR/scripts/embed.py \
  --jsonl records.jsonl \
  --output records_with_embeddings.jsonl \
  --batch-size 32

Output is the same JSONL with an added embedding field per line.

Flags

FlagDefaultDescription
--text—Embed one string (mutually exclusive with --jsonl)
--jsonl—Embed many; each line must have a text field
--outputrequiredOutput path
--modelqwen/qwen3-embedding-8bAny embedding model on OpenRouter
--batch-size32Records per API call (jsonl mode)
--dimensions—Optional: truncate to N dims if supported

Endpoint

POST /api/v1/embeddings — OpenAI-compatible schema.

Request:

json
{ "model": "qwen/qwen3-embedding-8b", "input": ["text1", "text2", ...] }

Response:

json
{ "data": [ { "embedding": [0.01, -0.02, ...], "index": 0 }, ... ], "model": "...", "usage": {...} }

Notes

  • qwen3-embedding-8b outputs high-dimensional dense vectors suitable for semantic similarity, clustering, RAG.
  • For cheaper batches, consider qwen/qwen3-embedding-4b or other listed embedding models (GET /api/v1/embeddings/models).

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

Files

SKILL.md and 2 other files (scripts) in skills/data2story/designer/scripts/openrouter-embeddings of QinghongLin/data2story-skill.

  • SKILL.md
  • config.json
  • scripts/embed.py

Open the folder on GitHubat commit 63a55c1

Compare with similar skills

Openrouter Embeddings 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.

Openrouter Embeddings compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openrouter Embeddings this skillQinghongLin/data2story-skill155—~499Automated safety check: PassMIT
Embeddings via 9Routerdecolua/9router31k—~604Automated safety check: PassMIT
Openrouter Imgrtadewald/skills185—~800Automated safety check: NotesNone
Page AgentTommy-yw/RunbookHermes5463 repos~2.3kAutomated safety check: NotesMIT
FreeRide Free Model ManagerShaivpidadi/FreeRide2382 repos~1.1kAutomated safety check: PassNone
Using Ccproxy Inspectorstarbaser/ccproxy350—~2.7kAutomated safety check: PassCustom licence

Similar skills

  • Embeddings via 9Router

    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.

    31k GitHub stars~604 tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Openrouter Img

    rtadewald/skills

    Generate or edit images via OpenRouter Image API across top models (Nano Banana, GPT Image, FLUX.2, Seedream, Qwen, Grok).

    185 GitHub stars~800 tokensUpdated 12 days ago
    Media & CreativeAuto-check: notes
  • Page Agent

    Tommy-yw/RunbookHermes

    Embed alibaba/page-agent into your own web application — a pure-JavaScript in-page GUI agent that ships as a single <script tag or npm package and lets end-users of your site drive the UI with…

    546 GitHub starsUsed in 3 repos~2.3k tokens
    Productivity & AutomationAuto-check: notes
  • FreeRide Free Model Manager

    Shaivpidadi/FreeRide

    Configures OpenClaw to use free OpenRouter models, setting the best one as primary and adding ranked fallbacks so rate limits do not interrupt work.

    238 GitHub starsUsed in 2 repos~1.1k tokens
    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
  • Outsourcerer

    alexgreensh/outsourcerer

    Cross-harness orchestrator for AI coding work. An agent skill from alexgreensh/outsourcerer.

    171 GitHub stars~5.5k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes

More from QinghongLin/data2story-skill

All 31 skills in this repo
  • Inspector

    QinghongLin/data2story-skill

    Run sentence-level traceability verification on a Data2Story blog (verify.py - verifier.json), then emit the in-page Inspector panel (the reader-facing runnable verifier) + the verify/ artifacts…

    155 GitHub stars~3.1k tokensUpdated 3 mo ago
    Auto-check: notes
  • Auditor

    QinghongLin/data2story-skill

    Audit a generated Data2Story blog for build correctness across ALL modalities by ACTUALLY RENDERING it in a real headless browser (when available) — catching blank/0-width charts, broken/oversized…

    155 GitHub stars~6.4k tokensUpdated 3 mo ago
    Auto-check: notes
  • Critic

    QinghongLin/data2story-skill

    Review a finished Data2Story blog against the 5 quality rubric dimensions (visualdesign, narrativepacing, datamethodtransparency, claimdataalignment, insightvalue), score each 1-7 with on-page…

    155 GitHub stars~4.7k tokensUpdated 3 mo ago
    Auto-check: notes
  • Detective

    QinghongLin/data2story-skill

    Research external context for a dataset — domain background, history, related studies, and why this data matters.

    155 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check: notes
  • Inspector

    QinghongLin/data2story-skill

    Run sentence-level traceability verification on a blog, then generate viewer.html with interactive evidence panel.

    155 GitHub stars~697 tokensUpdated 3 mo ago
    Auto-check: notes
  • Data2story Pro

    QinghongLin/data2story-skill

    A skill your agent uses to turn a dataset into a verifiable multimedia blog (a data story / data-driven article / interactive dashboard from a dataset).

    155 GitHub stars~14k tokensUpdated 3 mo ago
    Auto-check: notes

Works with

Questions about Openrouter Embeddings

What does Openrouter Embeddings do?

Generate text embeddings via OpenRouter using Qwen3-Embedding-8B. Openrouter Embeddings is an agent skill from QinghongLin/data2story-skill. Generate text embeddings via OpenRouter using Qwen3-Embedding-8B.

When should I use Openrouter Embeddings?

Openrouter Embeddings fits situations like: tasks that involve Embeddings; tasks that involve Model routing and gateways.

How do I install Openrouter Embeddings in Claude Code?

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

How do I install Openrouter Embeddings in Codex?

Run `npx skills add QinghongLin/data2story-skill --skill openrouter-embeddings -a codex`. Or copy the skill folder (skills/data2story/designer/scripts/openrouter-embeddings in QinghongLin/data2story-skill) into .agents/skills/openrouter-embeddings in your project. Codex loads it when a task matches its description.

Can I use Openrouter Embeddings 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 QinghongLin/data2story-skill --skill openrouter-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/openrouter-embeddings, .gemini/skills/openrouter-embeddings, .github/skills/openrouter-embeddings and .opencode/skills/openrouter-embeddings in your project.

What does Openrouter Embeddings need to run?

Going by SKILL.md and its folder, Openrouter Embeddings needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named OPENROUTER_API_KEY. Our summary lists: Python 3; A credential in OPENROUTER_API_KEY.

Does Openrouter Embeddings access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Openrouter Embeddings 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Openrouter Embeddings use?

Openrouter Embeddings 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 Openrouter Embeddings use?

About 499 tokens (SKILL.md is roughly 2k 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 Openrouter Embeddings?

Skills that share tags, products or a category with Openrouter Embeddings: Embeddings via 9Router (decolua/9router, 31k stars), Openrouter Img (rtadewald/skills, 185 stars), Page Agent (Tommy-yw/RunbookHermes, 546 stars) and FreeRide Free Model Manager (Shaivpidadi/FreeRide, 238 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openrouter Embeddings?

QinghongLin (a GitHub user) maintains it in QinghongLin/data2story-skill, which has 155 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on July 5, 2026.

Source: QinghongLin/data2story-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.