# audio-transcription

Transcribes local or web audio into text with timestamps via the PostPlus CLI and converts existing timed transcripts into SRT or ASS subtitles.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1300 installs · ★ 27
- Author: PostPlusAI
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostPlusAI/postplus-skills/tree/HEAD/skills/40-creative/audio-transcription/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/audio-transcription

## What it does

This skill guides the agent to process speech through the `postplus media transcribe` command. You can pass local sound files, HTTPS links, or data URIs into the `--audio` argument. The CLI handles jobs asynchronously, saving internal runs and manifests into `.postplus/audio-transcription`.

Supplying the file duration in `--duration-seconds` is mandatory. The CLI validates media duration beforehand, stopping execution immediately if the flag is omitted. Hosted transcription consumes PostPlus credits, so jobs pause whenever the account balance runs out.

Generating subtitle files like SRT or ASS from an existing transcript happens locally. You do not spend credits on another remote call just to change formats. For draft passes, the tool provides an economical variant alongside the default high-precision model.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill audio-transcription -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/audio-transcription/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/audio-transcription/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill audio-transcription -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/audio-transcription/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill audio-transcription -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/audio-transcription/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostPlusAI/postplus-skills audio-transcription
```

2. **Manually: put the files in place**
- File: `.github/skills/audio-transcription/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill audio-transcription -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostPlusAI/postplus-skills --path skills/40-creative/audio-transcription
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/audio-transcription/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill audio-transcription -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/PostPlusAI/postplus-skills/tree/HEAD/skills/40-creative/audio-transcription/SKILL.md

## When to use it
- transcribe local audio tracks or remote URLs with exact timestamps
- convert existing timed transcripts to SRT or ASS subtitles locally
- run postplus doctor diagnostics to verify skill setup
- generate quick draft transcripts using the economical model variant

## Example prompts
- Transcribe ./meeting.wav with duration-seconds set to 180 and keep timestamps
- Convert ./result.json into an SRT subtitle file locally
- Run postplus doctor --skill audio-transcription to verify my setup

## Similar
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [writing-for-agents](https://affpapa.org/en/nevibecode/skills/writing-for-agents.md) — skill · 466719 installs
- [media-use](https://affpapa.org/en/nevibecode/skills/media-use.md) — skill · 1100000 installs
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [subagent-driven-development](https://affpapa.org/en/nevibecode/skills/subagent-driven-development.md) — skill · 237746 installs
- [orchestration](https://affpapa.org/en/nevibecode/skills/orchestration.md) — skill · 349800 installs

From the same set: [postplusai/postplus-skills](https://affpapa.org/en/nevibecode/by/postplusai/postplus-skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md