openrouter-stt — Claude Code skill: what it does, how to install
openrouter-stt converts audio recordings into text using OpenRouter's speech-to-text API across models like Whisper and Chirp.
no license 319 installs ★ 327 updated 2026-10-24
npx skills add OpenRouterTeam/skills --skill openrouter-stt -a claude-codeWhat openrouter-stt does
This skill instructs coding assistants how to query POST /api/v1/audio/transcriptions. It turns audio files into base64 payloads inside a standard JSON body and handles network requests using curl, TypeScript fetch, or Python requests. The API delivers the transcribed text along with billing details.
This endpoint is completely incompatible with OpenAI SDK conventions: sending multipart/form-data with a file attachment fails immediately. You must export an OPENROUTER_API_KEY environment variable before sending any transcription request.
The input_audio.format value must mirror the underlying audio encoding, whether wav, mp3, flac, m4a, ogg, webm, or aac. Mismatched containers cause mis-decoded transcripts or 400 validation failures.
What it helps with
- convert recorded meetings and audio files into plain text
- generate captions from extracted video audio tracks
- query OpenRouter models supporting transcription modality
- pass vocabulary prompts to specific transcription providers
Example prompts for the agent
- Transcribe meeting.wav using google/chirp-3 via OpenRouter
- Extract text from interview.mp3 using openai/whisper-large-v3
- List all available transcription models on OpenRouter
How to install openrouter-stt
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-stt -a claude-code2Manually: put the files in place
~/.claude/skills/openrouter-stt/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/openrouter-stt/
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-stt -a codex2Manually: put the files in place
.agents/skills/openrouter-stt/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-stt -a cursor2Manually: put the files in place
.cursor/skills/openrouter-stt/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OpenRouterTeam/skills skills/openrouter-stt2Manually: put the files in place
.github/skills/openrouter-stt/SKILL.md1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-stt -a gemini-cli2Platform CLI
gemini skills install https://github.com/OpenRouterTeam/skills --path skills/openrouter-sttManually: put the files in place
.devin/skills/openrouter-stt/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-stt -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about openrouter-stt
How to install openrouter-stt in Claude Code?
Run npx skills add OpenRouterTeam/skills --skill openrouter-stt -a claude-code in your terminal.
What does openrouter-stt do?
It guides AI agents on preparing base64 payloads and making valid HTTP requests to OpenRouter's speech-to-text service.
Can I use the official OpenAI SDK with this endpoint?
No, OpenRouter accepts JSON payloads with embedded base64 audio rather than the multipart form expected by OpenAI client libraries.