transcribe

Transcribe audio files into text or speaker-labeled JSON segments.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/DanialHaseeb/dotfiles --skill transcribe-danialhaseeb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: transcribe
Source: https://github.com/DanialHaseeb/dotfiles/tree/main/codex/skills/transcribe
Command: npx skills add https://github.com/DanialHaseeb/dotfiles --skill transcribe-danialhaseeb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Turn recorded speech into clean, usable text and optionally label who spoke when, removing the manual effort of listening, summarizing, and annotating audio recordings.

Core Features & Use Cases

  • Fast, reliable transcription: Defaults to a fast text-first model for quick turnarounds.
  • Speaker diarization & known-speaker hints: Produce speaker-labeled segments using up to four known-speaker references for interviews and meeting notes.
  • Batch and file management: Handle single or multiple audio files, automatic chunking for longer audio, and save outputs under a structured output directory for evaluation and archival.
  • Use Case: Convert meeting recordings into diarized JSON for note-taking and extract plain transcripts for publication.

Quick Start

Run the transcribe CLI on a recording to produce a readable transcript or a diarized JSON with speaker labels.

Frequently Asked Questions about transcribe

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transcribe an audio recording with speaker labels?

To transcribe audio with speaker labels, you can use the diarization feature by providing up to four known-speaker references. The Skill outputs a diarized JSON file containing speaker-labeled segments for meetings and interviews.

Do I need an OpenAI API key to transcribe audio files?

Yes, transcribing audio files requires an OpenAI API key and the openai Python SDK. The Skill uses OpenAI's speech-to-text models to convert recordings into accurate text or diarized JSON outputs.

Can I transcribe long audio files that exceed standard limits?

Yes, you can transcribe long audio files because the Skill supports automatic chunking. It automatically splits longer audio recordings into manageable segments to ensure reliable speech-to-text processing.

What is the best way to convert podcast audio to text format?

The best way to convert podcast audio to text is using the CLI's fast text-first model for quick turnarounds. It processes podcasts and outputs clean plain text transcripts ready for publication or note-taking.

What output formats are supported for speech-to-text transcription?

Speech-to-text transcription supports text, JSON, and diarized JSON output formats. You can save these outputs under a structured output directory for evaluation, archival, or downstream note-taking.

Does audio transcription work for batch processing multiple recordings?

Yes, audio transcription supports batch processing for single or multiple files. It handles multiple recordings and saves the resulting transcripts or diarized JSON segments in a structured directory.