Skip to main content
skill CX Codex

openrouter-tts — Claude Code skill: what it does, how to install

openrouter-tts synthesizes speech audio from text using OpenRouter's speech API. Generates voiceovers, audiobook snippets, and audio files right from your prompt.

no license 327 installs ★ 327 updated 2026-10-24

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

What openrouter-tts does

The skill equips the assistant to call OpenRouter's POST /api/v1/audio/speech endpoint using curl or OpenAI-compatible client libraries. Successful calls return raw binary audio rather than a JSON payload, so the agent writes the bytes directly to a media file.

An OPENROUTER_API_KEY environment variable is mandatory. The default format returned by the endpoint is uncompressed pcm, which will fail to play if saved under a .mp3 extension. Setting response_format to mp3 explicitly is required for standard media players.

Voice names are provider-specific. OpenAI models accept identifiers like alloy or nova, whereas engines like Voxtral or Kokoro require their own custom tags. The skill also handles model discovery by querying the models endpoint with speech modality filters.

What it helps with

  • Convert article drafts or scripts into playable mp3 audio
  • Query OpenRouter for speech models and their supported voice names
  • Adjust voice tone and pacing via OpenAI provider options
  • Export raw pcm audio streams for custom processing pipelines

Example prompts for the agent

  • Convert script.txt into an mp3 file using openai/gpt-4o-mini-tts-2025-12-15 with the alloy voice
  • List all TTS models and supported voices available on OpenRouter
  • Generate an audio clip with a slow, warm tone using provider instructions

How to install openrouter-tts

1Skills CLI (Vercel)

npx skills add OpenRouterTeam/skills --skill openrouter-tts -a claude-code

2Manually: put the files in place

~/.claude/skills/openrouter-tts/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/openrouter-tts/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about openrouter-tts

How to install openrouter-tts in Claude Code?

Run npx skills add OpenRouterTeam/skills --skill openrouter-tts -a claude-code. Alternatively, copy the definition directly into ~/.claude/skills/openrouter-tts/SKILL.md.

What does openrouter-tts do?

It allows your coding assistant to synthesize speech from text files or prompts by routing requests to speech models hosted on OpenRouter.

Why is the generated mp3 file unplayable?

The endpoint outputs raw pcm bytes unless you set response_format to mp3. Saving raw samples with an .mp3 extension corrupts playback.

Similar skills

All skills for AI and ML →

From the same set16

The whole set →
openrouter-generations openrouter-generations is a Claude Code skill for inspecting OpenRouter requests by generation ID. It shows token costs, latency, provider routing, and saved prompts. CX Codex +1 383installs openrouter-agent-migration openrouter-agent-migration walks you through switching agent imports from @openrouter/sdk to the @openrouter/agent package. CX Codex +1 383installs openrouter-oauth openrouter-oauth adds Sign In with OpenRouter to browser apps via OAuth PKCE without a backend, SDK, or client credentials. CX Codex +1 362installs create-agent-tui create-agent-tui is a Claude Code skill that generates a TypeScript agent with terminal UI, tools, and sessions for building an agent from scratch or adding a terminal interface. CX Codex +1 358installs openrouter-analytics-schema Fetches live OpenRouter analytics schema details, including metrics, dimensions, and filter rules. Useful when constructing usage or cost queries. CX Codex +1 355installs openrouter-analytics-query openrouter-analytics-query — a skill for building and running queries against the OpenRouter analytics API. Use it to pull metrics on model usage, group results by dimensions, and filter by time, model, or other parameters. CX Codex +1 355installs create-headless-agent create-headless-agent scaffolds headless TypeScript agents using Bun and @openrouter/agent. Builds CLI utilities, API servers, queue workers, and data pipelines without a terminal UI. CX Codex +1 320installs openrouter-stt openrouter-stt converts audio recordings into text using OpenRouter's speech-to-text API across models like Whisper and Chirp. CX Codex +1 319installs

Project sponsors

Companies that keep this analytics open