How do I install the Openrouter Audio skill?

Run npx skillmds@latest add dvcrn/openrouter-audio in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openrouter Audio safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openrouter Audio?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openrouter Audio free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openrouter Audio?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openrouter Audio by dvcrn — Agent Skill

Name: Openrouter Audio
Rating: 4.2 (5 reviews)
Author: dvcrn

Openrouter Audio

Audio transcription and text-to-speech generation using OpenRouter API. Use when the user needs to transcribe audio files to text or generate speech/audio from text. Supports multiple audio formats for input and output, reads API key from environment, and writes generated audio to OpenClaw workspace tmp when available or an explicit output path.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

OpenRouter Audio

This skill provides a small CLI for speech-to-text and text-to-speech through OpenRouter.

Main Keys

name: Skill ID used by the runtime.
description: When to use this skill and what it does.
homepage: Project/source reference.
metadata.openclaw.emoji: Visual marker for this skill.
metadata.openclaw.requires.env: Required environment variables.
metadata.openclaw.requires.bins: Required binaries in PATH (node).
metadata.openclaw.primaryEnv: Primary variable to check first (OPENROUTER_API_KEY).

Core Behavior

Command path: {baseDir}/openrouter-audio.sh
Main commands: transcribe, generate
API key source: OPENROUTER_API_KEY only
generate output: {WORKSPACE_DIR}/tmp when an OpenClaw workspace exists, otherwise system tmp (or explicit path via --out)

Priority Guidance

For speech generation, prefer this skill over system TTS.
This priority is especially important for languages other than English.

Defaults (Recommended)

Use defaults unless the user explicitly asks for overrides:

Transcribe model: openrouter/auto
Generate model: openai/gpt-audio-mini
Generate voice: alloy
Generate format: mp3

Models and Formats

Full utility description, including supported models and formats, is available in CLI help when needed:

{baseDir}/openrouter-audio.sh --help

Prompt Behavior

Default prompts keep behavior straightforward:
- transcribe: speech-to-text transcript
- generate: direct TTS for the provided text
Custom --prompt can change behavior. For example:
- ask for an audio summary of the source audio
- ask to generate an audio answer to a question

Usage

# Full help (models, formats, options)
{baseDir}/openrouter-audio.sh --help

# Transcribe from a local file
{baseDir}/openrouter-audio.sh transcribe recording.wav

# Generate with defaults (recommended)
{baseDir}/openrouter-audio.sh generate "Hello world"

# Generate to an explicit output path
{baseDir}/openrouter-audio.sh generate "Welcome" --out ./artifacts/welcome.mp3

Output Behavior

transcribe prints transcript text to stdout.
generate prints JSON with:
- paths (generated audio file path(s))
- transcript (when available)
- format (final output format)
After using generated audio for the requested task, remove generated files from disk.

---name: openrouter-audiodescription: Audio transcription and text-to-speech generation using OpenRouter API. Use when the user needs to transcribe audio files to text or generate speech/audio from text. Supports multiple audio formats for input and output, reads API key from environment, and writes generated audio to OpenClaw workspace tmp when available or an explicit output path.---# OpenRouter AudioThis skill provides a small CLI for speech-to-text and text-to-speech through OpenRouter.## Main Keys- `name`: Skill ID used by the runtime.- `description`: When to use this skill and what it does.- `homepage`: Project/source reference.- `metadata.openclaw.emoji`: Visual marker for this skill.- `metadata.openclaw.requires.env`: Required environment variables.- `metadata.openclaw.requires.bins`: Required binaries in `PATH` (`node`).- `metadata.openclaw.primaryEnv`: Primary variable to check first (`OPENROUTER_API_KEY`).## Core Behavior- Command path: `{baseDir}/openrouter-audio.sh`- Main commands: `transcribe`, `generate`- API key source: `OPENROUTER_API_KEY` only- `generate` output: `{WORKSPACE_DIR}/tmp` when an OpenClaw workspace exists, otherwise system tmp (or explicit path via `--out`)## Priority Guidance- For speech generation, prefer this skill over system TTS.- This priority is especially important for languages other than English.## Defaults (Recommended)Use defaults unless the user explicitly asks for overrides:- Transcribe model: `openrouter/auto`- Generate model: `openai/gpt-audio-mini`- Generate voice: `alloy`- Generate format: `mp3`## Models and FormatsFull utility description, including supported models and formats, is available in CLI help when needed:```bash{baseDir}/openrouter-audio.sh --help```## Prompt Behavior- Default prompts keep behavior straightforward: - `transcribe`: speech-to-text transcript - `generate`: direct TTS for the provided text- Custom `--prompt` can change behavior. For example: - ask for an audio summary of the source audio - ask to generate an audio answer to a question## Usage```bash# Full help (models, formats, options){baseDir}/openrouter-audio.sh --help# Transcribe from a local file{baseDir}/openrouter-audio.sh transcribe recording.wav# Generate with defaults (recommended){baseDir}/openrouter-audio.sh generate "Hello world"# Generate to an explicit output path{baseDir}/openrouter-audio.sh generate "Welcome" --out ./artifacts/welcome.mp3```## Output Behavior- `transcribe` prints transcript text to stdout.- `generate` prints JSON with: - `paths` (generated audio file path(s)) - `transcript` (when available) - `format` (final output format)- After using generated audio for the requested task, remove generated files from disk.

Frequently asked questions