How do I install the Transcribe skill?

Run npx skillmds@latest add ma08/transcribe 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 Transcribe safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Transcribe?

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

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

Who published Transcribe?

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

Transcribe by ma08 — Agent Skill

Name: Transcribe
Author: ma08

File contents

Transcribe Skill

Transcribe audio and video files to text using speech-to-text providers (currently Soniox).

When to Use

User has audio or video files to transcribe
User wants to convert meeting recordings, interviews, or media to text
User needs batch transcription of a directory of files
User mentions transcription, speech-to-text, or converting audio/video to text

How to Use

Single file

uv run ~/pro/personal_os/scripts/transcribe.py --input recording.mp4

Directory of files

uv run ~/pro/personal_os/scripts/transcribe.py --input /path/to/videos/ --output-dir /path/to/output/

With domain context and terms

uv run ~/pro/personal_os/scripts/transcribe.py --input meeting.m4a \
  --context "Board meeting Q4 review" \
  --terms "EBITDA,YoY,ARR,Zone,Simply South"

Arguments Reference

Flag	Short	Description	Default
`--input`	`-i`	Audio/video file or directory (required)	--
`--output-dir`	`-o`	Output directory	Same as input
`--provider`	`-p`	STT provider (`soniox`)	`soniox`
`--context`	`-c`	Free-text context for accuracy	`""`
`--terms`	`-t`	Comma-separated domain terms	`""`
`--language`	`-l`	Language hint ISO code	`en`
`--no-cleanup`		Keep remote files after transcription	`false`
`--no-combined`		Skip combined transcript for directories	`false`

Supported Formats

.mov, .mp4, .m4a, .mp3, .wav, .webm, .ogg, .flac, .aac, .aiff, .amr, .asf

Output Files

For each input file example.mp4:

example-transcript.json - Raw API response with tokens
example-transcript.md - Readable markdown with speaker labels

For multi-file runs (unless --no-combined):

combined-transcript.md - All transcripts in one file

Requirements

SONIOX_API_KEY must be set in the environment or in ~/pro/personal_os/.env
Keep the machine-local .env mode 0600; never copy the key into task artifacts or source control.
Use the canonical ~/pro/personal_os/scripts/transcribe.py path so the command works regardless of the current directory.
Get an API key at https://console.soniox.com

Typical Workflow

User provides audio/video file(s)
Run the transcribe script with appropriate context/terms
Review the generated markdown transcript
Use the transcript for meeting notes, documentation, or content

Examples in Context

Meeting recording:

uv run ~/pro/personal_os/scripts/transcribe.py -i ~/Downloads/standup-2026-02-05.m4a \
  -o context/daily/2026-02-05/standup/ \
  --context "Daily standup meeting, Zone team" \
  --terms "Zone,ZonEye,Simply South,Vinoz"

Batch factory tour videos:

uv run ~/pro/personal_os/scripts/transcribe.py -i /path/to/factory-videos/ \
  -o context/daily/2026-02-05/factory-tour/ \
  --context "Factory tour at candy manufacturing facility" \
  --terms "tempering,enrobing,fondant,ganache"

---name: transcribedescription: Transcribe audio/video files using speech-to-text providers. Use when user has audio or video files to transcribe.---# Transcribe SkillTranscribe audio and video files to text using speech-to-text providers (currently Soniox).## When to Use- User has audio or video files to transcribe- User wants to convert meeting recordings, interviews, or media to text- User needs batch transcription of a directory of files- User mentions transcription, speech-to-text, or converting audio/video to text## How to Use### Single file```bashuv run ~/pro/personal_os/scripts/transcribe.py --input recording.mp4```### Directory of files```bashuv run ~/pro/personal_os/scripts/transcribe.py --input /path/to/videos/ --output-dir /path/to/output/```### With domain context and terms```bashuv run ~/pro/personal_os/scripts/transcribe.py --input meeting.m4a \ --context "Board meeting Q4 review" \ --terms "EBITDA,YoY,ARR,Zone,Simply South"```## Arguments Reference| Flag | Short | Description | Default ||------|-------|-------------|---------|| `--input` | `-i` | Audio/video file or directory (required) | -- || `--output-dir` | `-o` | Output directory | Same as input || `--provider` | `-p` | STT provider (`soniox`) | `soniox` || `--context` | `-c` | Free-text context for accuracy | `""` || `--terms` | `-t` | Comma-separated domain terms | `""` || `--language` | `-l` | Language hint ISO code | `en` || `--no-cleanup` | | Keep remote files after transcription | `false` || `--no-combined` | | Skip combined transcript for directories | `false` |## Supported Formats`.mov`, `.mp4`, `.m4a`, `.mp3`, `.wav`, `.webm`, `.ogg`, `.flac`, `.aac`, `.aiff`, `.amr`, `.asf`## Output FilesFor each input file `example.mp4`:- `example-transcript.json` - Raw API response with tokens- `example-transcript.md` - Readable markdown with speaker labelsFor multi-file runs (unless `--no-combined`):- `combined-transcript.md` - All transcripts in one file## Requirements- `SONIOX_API_KEY` must be set in the environment or in `~/pro/personal_os/.env`- Keep the machine-local `.env` mode `0600`; never copy the key into task artifacts or source control.- Use the canonical `~/pro/personal_os/scripts/transcribe.py` path so the command works regardless of the current directory.- Get an API key at https://console.soniox.com## Typical Workflow1. User provides audio/video file(s)2. Run the transcribe script with appropriate context/terms3. Review the generated markdown transcript4. Use the transcript for meeting notes, documentation, or content## Examples in Context**Meeting recording:**```bashuv run ~/pro/personal_os/scripts/transcribe.py -i ~/Downloads/standup-2026-02-05.m4a \ -o context/daily/2026-02-05/standup/ \ --context "Daily standup meeting, Zone team" \ --terms "Zone,ZonEye,Simply South,Vinoz"```**Batch factory tour videos:**```bashuv run ~/pro/personal_os/scripts/transcribe.py -i /path/to/factory-videos/ \ -o context/daily/2026-02-05/factory-tour/ \ --context "Factory tour at candy manufacturing facility" \ --terms "tempering,enrobing,fondant,ganache"```

Frequently asked questions

Transcribe