skill

transcribe — Claude Code skill: what it does, how to install

Q: How to install transcribe in Claude Code?

Run `npx claude-code-templates@latest --skill media/transcribe` in your terminal. This configures the skill for Claude Code.

Q: What dependencies are required?

You need Python 3, the `openai` package installed via `uv pip install openai` or pip, and an exported `OPENAI_API_KEY`.

Transcribes audio recordings into text and identifies speakers using OpenAI models. Helpful when processing interviews and team meetings.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --skill media/transcribe

Open on GitHub

What transcribe does

The skill handles speech-to-text workflows through an included script named transcribe_diarize.py. Standard runs send recordings to gpt-4o-mini-transcribe to generate simple text files quickly. When multi-speaker tracking is needed, it switches to gpt-4o-transcribe-diarize to return structured JSON with segmented dialogs.

You can provide audio references for up to 4 known speakers to improve diarization accuracy. However, custom prompts are unavailable under the diarization model. Any clip exceeding roughly 30 seconds triggers automated chunking to prevent processing limits.

Executing these jobs requires Python 3 with the openai package and a valid OPENAI_API_KEY. The script halts immediately if the key is missing from your shell variables. Outputs land in output/transcribe/ unless you pass a custom destination with --out or --out-dir.

What it helps with

transcribe speech from an audio recording into plain text
separate speaker turns across an interview recording
match participants against sample reference audio
export structured diarized dialogue to JSON

Example prompts for the agent

Transcribe the audio file interview.mp3 and save the plain text output to interview.txt
Run speaker diarization on meeting.m4a using voice samples refs/alice.wav and refs/bob.wav
Convert voice.wav into text using the fast default model

How to install transcribe

1claude-code-templates

npx claude-code-templates@latest --skill media/transcribe

2Skills CLI (Vercel)

npx skills add davila7/claude-code-templates --skill transcribe -a claude-code

3Manually: put the files in place

~/.claude/skills/transcribe/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/transcribe/

Manually: put the files in place

.agents/skills/transcribe/SKILL.md

For all projects use ~/.agents/skills/

Manually: put the files in place

.cursor/skills/transcribe/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install davila7/claude-code-templates transcribe

2Manually: put the files in place

.github/skills/transcribe/SKILL.md

Platform CLI

gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/media/transcribe

Manually: put the files in place

.devin/skills/transcribe/SKILL.md

The legacy .windsurf/skills/ path still works

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about transcribe

How to install transcribe in Claude Code?

Run npx claude-code-templates@latest --skill media/transcribe in your terminal. This configures the skill for Claude Code.

What does transcribe do?

It triggers a Python CLI tool that passes audio files to OpenAI transcription models, outputting plain text or diarized JSON.

What dependencies are required?

You need Python 3, the openai package installed via uv pip install openai or pip, and an exported OPENAI_API_KEY.

Similar skills

All skills for AI and ML →

skill-creator official anthropics Creates and refines skills, then tests them with prompts, evaluations, and performance checks. 414,180installs writing-for-agents Matt Pocock Guidance for writing skills and agent-facing documents. Use it when editing AGENTS.md, CLAUDE.md, or reference files reached from them. 466,719installs media-use heygen-com Finds or generates media for HyperFrames videos, including voiceovers, music, cutouts, and color grades. Stores files locally in assets. CX Codex +1 1,100,000installs mcp-builder official anthropics This skill walks through building an MCP server in TypeScript or Python, from reading the protocol spec to writing tests and evaluation questions. 130,949installs subagent-driven-development Jesse Vincent This skill runs an implementation plan through fresh subagents for independent tasks and reviews each result. Use it for multi-step work in one session. CX Codex 237,746installs orchestration stablyai Coordinates supervised Orca workers with task DAGs, decision gates, and threaded messages. Fits workflows that split work across multiple agents. CX Codex +1 350,300installs

From the same set804

The whole set →

issue-triage Triages incoming GitHub and Linear tasks, computes priority scores, and routes issues to matching teams. 276installs dependency-mapper Builds a dependency graph for code and tasks, detects cycles and calculates the critical path. Useful before sprint planning or a refactor. 274installs rag-engineer A skill for designing RAG systems: document chunking, embeddings, hybrid search and reranking. Useful when answer quality is capped by retrieval quality. 273installs business-scenario-explorer A slash command that maps out several business timelines — baseline, optimistic, pessimistic and disruption — and turns them into a decision matrix. 273installs playwright-e2e-builder A skill that plans and builds Playwright E2E suites. It interviews you about flows and auth first, then writes the tests. 271installs update-branch-name Renames the active Git branch based on its changes against main. It is useful when you started coding on a temporary branch like temp. 270installs broken-authentication This skill guides security checks for web login flows, password rules, and session handling. Use it when reviewing authentication controls or multi-factor login. 269installs c4-architecture Creates software architecture documentation and C4 model diagrams using Mermaid syntax from your codebase. 269installs