whisper-transcribe

Transcribe audio and video to text using Whisper with markdown context grounding.

1|1|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/SpillwaveSolutions/whisper-transcribe --skill whisper-transcribe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whisper-transcribe
Source: https://github.com/SpillwaveSolutions/whisper-transcribe/tree/main/whisper-transcribe
Command: npx skills add https://github.com/SpillwaveSolutions/whisper-transcribe --skill whisper-transcribe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the transcription of audio and video files into text, using OpenAI's Whisper, and enhances accuracy with context grounding from per-directory markdown context files. It saves time, reduces manual proofreading, and supports a wide range of media formats.

Core Features & Use Cases

  • Audio/Video Transcription: Convert media files to text using OpenAI Whisper.
  • Context Grounding: Reads markdown context files in the same directory to improve terminology, names, and jargon accuracy.
  • Multi-format Support: Works with mp3, wav, m4a, mp4, webm, and more.
  • Cross-Platform: Install and run on macOS (Homebrew) or Linux.

Quick Start

Transcribe a file like '/path/to/video.mp4' and optionally ground terms from context:

  • Run basic transcription: whisper "/path/to/video.mp4" --output_dir "/path/to/output"
  • Or use the grounding script: python scripts/transcribe_with_context.py "/path/to/audio.mp3" --model base --language en

Frequently Asked Questions about whisper-transcribe

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

FAQPage Schema
How do I transcribe audio and video files to text?

Transcribe media files by running whisper with your file path and output directory. The Skill converts mp3, wav, m4a, mp4, webm, and other formats to text using OpenAI's Whisper model, supporting multiple output formats including txt, srt, vtt, and json.

Can I improve transcription accuracy for technical terms and proper nouns?

Yes. Place a markdown context file in the same directory as your media file to ground terminology. The Skill reads these context files automatically during transcription to correct technical terms, proper nouns, and jargon, reducing manual proofreading.

What media formats does Whisper transcription support?

Whisper transcription supports mp3, wav, m4a, mp4, webm, and additional audio and video formats. Configure output as txt, srt, vtt, json, or generate all formats simultaneously from a single media file.

How do I select a Whisper model and language for transcription?

Pass the --model and --language parameters when running transcription. The Skill satisfies requirements for model selection and language specification, allowing you to choose the appropriate Whisper model size and target language for accuracy.

Can I automate context-grounded transcription across multiple files?

Yes. Use the configurable workflow to run transcription_with_context.py with your media files and model settings. The Skill automates context-grounding corrections per directory, applying markdown context files systematically across batches.

What platforms and installation methods does this Skill support?

Install on macOS via Homebrew or on Linux systems. Cross-platform CLI execution enables transcription workflows on multiple environments without additional configuration beyond initial setup.