# Yao Audio

> Audio expert. ALWAYS invoke this skill when the user asks to transcribe, recognize, or convert speech/audio to text.

- Skill: `yaoapp/yao-audio` (Agent Skill)
- Install (CLI): `npx skillmds add yaoapp/yao-audio`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yaoapp/yao-audio/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: YaoApp (https://skillmd.com/u/yaoapp)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/yaoapp/yao-audio

---


# Audio Tools

Use these tools to transcribe audio files to text using speech-to-text models.

## audio_transcribe

Transcribe an audio file to text.

```bash
tai tool audio_transcribe --audio_path /path/to/meeting.m4a
```

```bash
tai tool audio_transcribe --audio_path /path/to/recording.wav --language en --provider llm.my-openai:whisper-1
```

| Parameter  | Type   | Required | Description                                                       |
| ---------- | ------ | -------- | ----------------------------------------------------------------- |
| audio_path | string | yes      | Audio file path. Supported: mp3, m4a, wav, webm, mp4, mpeg, mpga  |
| language   | string | no       | ISO 639-1 language code (e.g. `en`, `zh`, `ja`). Auto-detected if omitted |
| provider   | string | no       | STT provider connector ID. If omitted, uses the default STT provider |

## audio_providers

List available speech-to-text providers and models.

### List STT providers (default):
```bash
tai tool audio_providers
```

| Parameter  | Type   | Required | Description                          |
| ---------- | ------ | -------- | ------------------------------------ |
| capability | string | no       | Filter by capability (default: `audio`) |

Returns a list of providers with their available models and connector IDs that can be passed to `audio_transcribe`.

## Constraints

Only use the parameters listed above for each tool. Do not pass unsupported parameters — they will be ignored or cause errors.