How do I install the Speechmatics skill?

Run npx skillmds@latest add knownasnaffy/speechmatics-2 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 Speechmatics safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Speechmatics?

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 Speechmatics free to use?

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

Who published Speechmatics?

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

Speechmatics by knownasnaffy — Agent Skill

Name: Speechmatics
Rating: 4.5 (4 reviews)
Author: knownasnaffy

Speechmatics

Transcribe audio files (voice notes, recordings, podcasts) to text via the Speechmatics batch transcription API. Use when the user asks to transcribe audio, convert speech to text, or get a transcript of a recording, and Speechmatics is configured.

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

Speechmatics (batch transcription)

Transcribe an audio file via Speechmatics' async batch API. Submits a job, polls until complete, then writes the transcript.

Quick start

{baseDir}/scripts/transcribe.sh /path/to/audio.m4a

Defaults:

Language: en
Operating point: enhanced (better accuracy; use standard for faster/cheaper)
Output: <input>.txt in the same directory
Poll interval: 3s, timeout: 600s

Useful flags

{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --language da
{baseDir}/scripts/transcribe.sh /path/to/meeting.wav --operating-point standard
{baseDir}/scripts/transcribe.sh /path/to/call.mp3 --diarization speaker
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --format json --out /tmp/transcript.json
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --format srt --out /tmp/subs.srt
{baseDir}/scripts/transcribe.sh /path/to/long.wav --timeout 1800

Formats: txt (default, plain text), json (Speechmatics json-v2 with word timings), srt (subtitles).

API key

The script reads the API key from (in order):

--api-key <key> flag
SPEECHMATICS_API_KEY environment variable (set by openclaw from the entry below)
skills.entries.speechmatics.apiKey in $OPENCLAW_CONFIG_PATH (default ~/.openclaw/openclaw.json)

Configure via openclaw.json:

{
  skills: {
    entries: {
      speechmatics: {
        apiKey: "SPEECHMATICS_KEY_HERE",
      },
    },
  },
}

Override the API base (e.g. EU region or a proxy) with --base-url or SPEECHMATICS_BASE_URL. Default: https://asr.api.speechmatics.com/v2.

Notes

Supports most common audio formats (wav, mp3, m4a, ogg, flac, mp4, etc.) — Speechmatics transcodes server-side.
File size limit: 2 GB per job.
Batch jobs complete in roughly 1:10 wallclock to audio duration on enhanced; standard is faster.
Always confirm any destructive follow-up (e.g. replying based on a transcript) before acting.

---name: speechmatics-2description: Transcribe audio files (voice notes, recordings, podcasts) to text via the Speechmatics batch transcription API. Use when the user asks to transcribe audio, convert speech to text, or get a transcript of a recording, and Speechmatics is configured.---# Speechmatics (batch transcription)Transcribe an audio file via Speechmatics' async batch API. Submits a job, polls until complete, then writes the transcript.## Quick start```bash{baseDir}/scripts/transcribe.sh /path/to/audio.m4a```Defaults:- Language: `en`- Operating point: `enhanced` (better accuracy; use `standard` for faster/cheaper)- Output: `<input>.txt` in the same directory- Poll interval: 3s, timeout: 600s## Useful flags```bash{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --language da{baseDir}/scripts/transcribe.sh /path/to/meeting.wav --operating-point standard{baseDir}/scripts/transcribe.sh /path/to/call.mp3 --diarization speaker{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --format json --out /tmp/transcript.json{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --format srt --out /tmp/subs.srt{baseDir}/scripts/transcribe.sh /path/to/long.wav --timeout 1800```Formats: `txt` (default, plain text), `json` (Speechmatics json-v2 with word timings), `srt` (subtitles).## API keyThe script reads the API key from (in order):1. `--api-key <key>` flag2. `SPEECHMATICS_API_KEY` environment variable (set by openclaw from the entry below)3. `skills.entries.speechmatics.apiKey` in `$OPENCLAW_CONFIG_PATH` (default `~/.openclaw/openclaw.json`)Configure via openclaw.json:```json5{ skills: { entries: { speechmatics: { apiKey: "SPEECHMATICS_KEY_HERE", }, }, },}```Override the API base (e.g. EU region or a proxy) with `--base-url` or `SPEECHMATICS_BASE_URL`. Default: `https://asr.api.speechmatics.com/v2`.## Notes- Supports most common audio formats (wav, mp3, m4a, ogg, flac, mp4, etc.) — Speechmatics transcodes server-side.- File size limit: 2 GB per job.- Batch jobs complete in roughly 1:10 wallclock to audio duration on `enhanced`; `standard` is faster.- Always confirm any destructive follow-up (e.g. replying based on a transcript) before acting.

Frequently asked questions