---
name: yaoapp-yao-audio
description: "Audio expert. ALWAYS invoke this skill when the user asks to transcribe, recognize, or convert speech/audio to text."
license: "NOASSERTION"
metadata:
  decimalai-skill-id: "4553a37b-5653-4db5-afc8-39f01d586f3b"
  decimalai-version-id: "1dcbabcf-e78e-44fa-a69e-01c7ba2af061"
  decimalai-version: "1"
  decimalai-body-sha256: "82d2ccf3b5579d0a646c65d0a799b5a004963420a6350754712969e18a0958f3"
  decimalai-name: "yaoapp/yao-audio"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "design-media"
  decimalai-source: "https://app.decimal.ai/s/yaoapp-yao-audio@1/SKILL.md"
---
# 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.