Agent skill

Cost Openrouter

by ruvnet in ruvnet/ruflo

OpenRouter real spend — key limit and usage today/week/month, one request's billed cost by generation id, account credits.

MITAuto-check: notesAI & LLM Engineering

Install Cost Openrouter

skills CLI
$ npx skills add ruvnet/ruflo --skill cost-openrouter -a claude-code

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

GitHub CLI
$ gh skill install ruvnet/ruflo cost-openrouter --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/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ruflo-cost-tracker/skills/cost-openrouter .claude/skills/cost-openrouter && 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
cost-openrouter
GitHub stars
74k
Token cost
~336 tokens
SKILL.md length
112 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

OpenRouter real spend — key limit and usage today/week/month, one request's billed cost by generation id, account credits.

  • Asked what OpenRouter charged
  • Calls node; needs OPENROUTER_API_KEY and OPENROUTER_MANAGEMENT_KEY
  • Whether a key is near its limit

What it does

Cost Openrouter is an agent skill from ruvnet/ruflo. OpenRouter real spend — key limit and usage today/week/month, one request's billed cost by generation id, account credits. Use when asked what OpenRouter charged or whether a key is near its limit. Network and API key: asks first.

Its SKILL.md is about 340 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Model routing and gateways. It works with OpenRouter. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

When your agent uses it

  • Asked what OpenRouter charged
  • Whether a key is near its limit

Example prompts

  • “/cost-openrouter”

Requirements

  • A credential in OPENROUTER_API_KEY
  • A credential in OPENROUTER_MANAGEMENT_KEY
  • Pre-approved tools (allowed-tools): Bash

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    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
    • OPENROUTER_MANAGEMENT_KEY

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

Context cost

Cost Openrouter loads about 336 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 112 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

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 ruvnet/ruflo at commit 58e0ae7, republished under its MIT licence (© ruvnet). 112 words, ~336 tokens.

Download SKILL.mdSave it as .claude/skills/cost-openrouter/SKILL.md (or your agent's skills folder).
name
cost-openrouter
description
OpenRouter real spend — key limit and usage today/week/month, one request's billed cost by generation id, account credits. Use when asked what OpenRouter charged or whether a key is near its limit. Network and API key: asks first.
allowed-tools
Bash
argument-hint
key | generation <id> | credits

Cost OpenRouter

Network skill. Ask the user before running it, and run it only with their yes.

bash
node ${CLAUDE_PLUGIN_ROOT}/scripts/openrouter.mjs key --yes
node ${CLAUDE_PLUGIN_ROOT}/scripts/openrouter.mjs generation gen-abc123 --yes
node ${CLAUDE_PLUGIN_ROOT}/scripts/openrouter.mjs credits --yes

Rules

  • Without --yes the script prints the call it would make and sends nothing.
  • The key comes from OPENROUTER_API_KEY (credits: OPENROUTER_MANAGEMENT_KEY). Never ask the user to paste a key, never print, log or write one.
  • OpenRouter's usage.cost / total_cost is authoritative; do not recompute it from list prices.
  • credits needs a management key (a normal key returns 403). A fresh generation can 404 briefly: retry.
  • BYOK rows carry the 5% OpenRouter fee in usage, the provider's charge in upstream_inference_cost: show both, labelled.
  • Fallback and openrouter/auto can change the billed model: report model and provider_name as returned.

© ruvnet, 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 plugins/ruflo-cost-tracker/skills/cost-openrouter of ruvnet/ruflo.

Open the folder on GitHubat commit 58e0ae7

Compare with similar skills

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

Cost Openrouter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cost Openrouter this skillruvnet/ruflo74k—~336Automated safety check: NotesMIT
Freetoken Botslimin112/min-skill412—~1.3kAutomated safety check: PassNone
Add Modelget-convex/convex-evals130—~1.5kAutomated safety check: NotesApache-2.0
To Imgrtadewald/skills185—~673Automated safety check: NotesNone
Openrouterdavidondrej/skills4.1k—~1.3kAutomated safety check: PassMIT
Openrouter Text2musicQinghongLin/data2story-skill156—~618Automated safety check: PassMIT

Similar skills

  • Freetoken Bots

    limin112/min-skill

    Discover, verify, and maintain zero-priced OpenRouter models for Pi child-agent workflows used by Muse, Grokbot, or Dot.

    412 GitHub stars~1.3k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Add Model

    get-convex/convex-evals

    Add a new model to the convex-evals coding leaderboard, and optionally the decision benchmark, through a PR, then dispatch its baseline runs.

    130 GitHub stars~1.5k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes
  • To Img

    rtadewald/skills

    Gera imagens em paralelo via OpenRouter a partir de um pedido simples ou de um batch com prompts e filenames definidos.

    185 GitHub stars~673 tokensUpdated 11 days ago
    AI & LLM EngineeringAuto-check: notes
  • Openrouter

    davidondrej/skills

    Design, build, debug, and optimize OpenRouter API integrations.

    4.1k GitHub stars~1.3k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Openrouter Text2music

    QinghongLin/data2story-skill

    Generate atmospheric sound-design / SFX (NOT speech, NOT the front-of-blog BGM) via OpenRouter using Google Lyria 3 Pro.

    156 GitHub stars~618 tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Openrouter Text2music

    QinghongLin/data2story-skill

    Generate music (NOT speech) via OpenRouter using Google Lyria 3 Pro.

    156 GitHub stars~407 tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Works with

Questions about Cost Openrouter

What does Cost Openrouter do?

OpenRouter real spend — key limit and usage today/week/month, one request's billed cost by generation id, account credits. Cost Openrouter is an agent skill from ruvnet/ruflo. OpenRouter real spend — key limit and usage today/week/month, one request's billed cost by generation id, account credits.

When should I use Cost Openrouter?

Cost Openrouter fits situations like: asked what OpenRouter charged; whether a key is near its limit.

How do I install Cost Openrouter in Claude Code?

Run `npx skills add ruvnet/ruflo --skill cost-openrouter -a claude-code`. Or copy the skill folder (plugins/ruflo-cost-tracker/skills/cost-openrouter in ruvnet/ruflo) into .claude/skills/cost-openrouter in your project. Claude Code loads it when a task matches its description.

How do I install Cost Openrouter in Codex?

Run `npx skills add ruvnet/ruflo --skill cost-openrouter -a codex`. Or copy the skill folder (plugins/ruflo-cost-tracker/skills/cost-openrouter in ruvnet/ruflo) into .agents/skills/cost-openrouter in your project. Codex loads it when a task matches its description.

Can I use Cost Openrouter 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 ruvnet/ruflo --skill cost-openrouter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cost-openrouter, .gemini/skills/cost-openrouter, .github/skills/cost-openrouter and .opencode/skills/cost-openrouter in your project.

What does Cost Openrouter need to run?

Going by SKILL.md and its folder, Cost Openrouter needs the command-line tools its instructions call (node) and credentials named OPENROUTER_API_KEY and OPENROUTER_MANAGEMENT_KEY. Our summary lists: A credential in OPENROUTER_API_KEY; A credential in OPENROUTER_MANAGEMENT_KEY. Its frontmatter pre-approves these tools: Bash.

Does Cost Openrouter 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 Cost Openrouter safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Cost Openrouter use?

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

About 336 tokens (SKILL.md is roughly 1.3k 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 Cost Openrouter?

Skills that share tags, products or a category with Cost Openrouter: Freetoken Bots (limin112/min-skill, 412 stars), Add Model (get-convex/convex-evals, 130 stars), To Img (rtadewald/skills, 185 stars) and Openrouter (davidondrej/skills, 4.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cost Openrouter?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,159 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 9, 2026.

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