transcribe

Transcribe meeting audio into text transcripts with optional speaker diarization.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires faster-whisper, torch, torchaudio, pyannote.audio, numpy, tqdm, python-dotenv, and includes scripts (resource) components.

What problem does it solve?

This Skill automates turning meeting audio into accurate transcripts using Whisper, enabling quick capture of discussions, decisions, and action items.

Core Features & Use Cases

  • Automated Transcription: Convert meeting recordings (.m4a, .mp3, .wav, etc.) into text with word-level timestamps.
  • Speaker Diarization (optional): Identify and label speakers when pyannote.audio is available and configured.
  • Workflow Integration: Automatically detect new audio in meetings/audio and save transcripts to meetings/transcripts for easy reference and downstream summarization.
  • Use Case: After a team meeting, generate a transcript and then run /summarize_meeting to extract action items and decisions.

Quick Start

  • Run /transcribe on a single file, for example: /transcribe .research/meetings/audio/2024-12-02-lab-meeting.m4a
  • Or transcribe all untranscribed audio in the folder: /transcribe .research/meetings/audio/

Frequently Asked Questions about transcribe

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

FAQPage Schema
How do I transcribe meeting audio to text with speaker labels?

You can transcribe meeting audio to text with speaker labels by using Whisper for transcription and optional pyannote.audio for diarization. It processes common formats like .m4a, .mp3, and .wav, saving transcripts with labeled speakers.

Can I automatically detect and transcribe new audio files in a folder?

Yes, you can automatically detect and transcribe new audio files in a folder. Running the transcription command on a directory will identify untranscribed audio files and save the resulting text transcripts to a designated output folder.

Do I need an HF_TOKEN to use Whisper for meeting transcription?

You do not need an HF_TOKEN for standard Whisper transcription, but an optional HF_TOKEN is required for speaker diarization. The diarization feature uses pyannote.audio, which needs this authentication token to function.

What's the best way to extract action items after converting meeting audio to a transcript?

The best way to extract action items after converting meeting audio to a transcript is to run a summarization command on the generated text file. This downstream workflow captures decisions and action items from the transcribed meeting content.

Does faster-whisper support word-level timestamps for audio recordings?

Yes, faster-whisper supports word-level timestamps for audio recordings. It converts your meeting audio into accurate text transcripts while providing precise timing data for each spoken word.

What Python dependencies are required for audio diarization and transcription?

Audio diarization and transcription require Python dependencies including faster-whisper, torch, torchaudio, pyannote.audio, numpy, and tqdm. These libraries handle the speech-to-text processing, speaker identification, and audio data manipulation.