mcpField
T
transcribe-and-analyze

transcribe-and-analyze

github.com/nicepkgCreative & media28869 installsUpdated 40w ago
Repository

About transcribe-and-analyze

transcribe-and-analyze is a command-line skill for transcribing audio and video URLs locally with WhisperKit, with transcript analysis available on request. Analysis can use OpenAI or local Ollama and produces summaries, insights, topics, quotes, and action items.

Key features

  1. 01Transcribe audio and video URLs locally
  2. 02Choose among Whisper model sizes
  3. 03Analyze transcripts with OpenAI or Ollama
  4. 04Use custom prompts for analysis
  5. 05Save transcripts and analyses as Markdown

Use cases

  1. 01Transcribe a YouTube video locally
  2. 02Extract insights and action items from a lecture
  3. 03Run multiple focused analyses on one transcript

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nicepkg/ai-workflow --skill transcribe-and-analyze

After installing, type/transcribe-and-analyzein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
configuration.md
troubleshooting.md
usage-patterns.md
scripts/
analyze_transcript.py
transcribe.py

Details

From the project README

Transcribe and Analyze

Local transcription of audio/video content using WhisperKit. Analysis is available on request using OpenAI or local Ollama.

Capabilities

  1. Transcription - Convert audio/video URLs to text using WhisperKit (runs locally, always available)
  2. Analysis - Extract insights from transcripts (only when user asks for it, supports OpenAI or Ollama)

Quick Start

Transcribe Only
python3 scripts/transcribe.py "https://youtube.com/watch?v=..."
Transcribe + Analyze (OpenAI)
python3 scripts/transcribe.py "https://youtube.com/watch?v=..."
python3 scripts/analyze_transcript.py whisper-transcriptions/video.md
Transcribe + Analyze (Local)
python3 scripts/transcribe.py "https://youtube.com/watch?v=..."
python3 scripts/analyze_transcript.py whisper-transcriptions/video.md --local

Transcription

Script Options
# Basic
python3 scripts/transcribe.py "URL"

# Custom output directory
python3 scripts/transcribe.py "URL" --output-dir "/path/to/save"

# Higher accuracy (slower)
python3 scripts/transcribe.py "URL" --model medium

# Without timestamps
python3 scripts/transcribe.py "URL" --no-timestamps

# Custom filename
python3 scripts/transcribe.py "URL" --filename "my-transcription.md"
Whisper Models
ModelSpeedAccuracyUse Case
tinyFastestLowestQuick drafts, testing
baseFastReasonableSimple content
smallBalancedGoodDefault - most use cases
mediumSlowerHighLectures, important content
largeSlowestHighestCritical accuracy needed
Dependencies

Script checks for these and provides install instructions if missing.

Output

Transcriptions save to ./whisper-transcriptions/ as markdown:

# Transcription

**Source:** https://youtube.com/watch?v=example
**Transcribed:** 2025-01-15 14:30:00
**Tool:** WhisperKit

---

[00:00:00.000 --> 00:00:05.000] Welcome to this video...

Analysis

Provider Options

OpenAI API (default):

python3 scripts/analyze_transcript.py transcript.md
python3 scripts/analyze_transcript.py transcript.md --model gpt-4o

Requires OPENAI_API_KEY environment variable.

Local Ollama:

python3 scripts/analyze_transcript.py transcript.md --local
python3 scripts/analyze_transcript.py transcript.md --local --model mistral

Requires Ollama running (ollama serve).

Script Options
# Default comprehensive analysis (OpenAI)
python3 scripts/analyze_transcript.py transcript.md

# Use local Ollama
python3 scripts/analyze_transcript.py transcript.md --local

# Specify model
python3 scripts/analyze_transcript.py transcript.md --model gpt-4o
python3 scripts/analyze_transcript.py transcript.md --local --model llama3.2

# Custom analysis prompt
python3 scripts/analyze_transcript.py transcript.md --prompt "List all tools mentioned"

# Custom output location
python3 scripts/analyze_transcript.py transcript.md --output ~/Documents/analysis.md

# Print to stdout instead of saving
python3 scripts/analyze_transcript.py transcript.md --print
Default Analysis Includes
  • Executive summary (2-3 paragraphs)
  • Key insights (5-7 bullet points)
  • Topics discussed with summaries
  • Notable quotes (3-5 memorable quotes)
  • Action items and recommendations
  • Additional observations
Custom Prompt Examples
--prompt "List all technologies and tools mentioned"
--prompt "What are the main arguments presented?"
--prompt "Extract all statistics and data points"
--prompt "Summarize in 5 bullet points"
--prompt "What questions were asked and how were they answered?"
Dependencies
  • openai - pip install openai (used for both OpenAI and Ollama)
  • OPENAI_API_KEY environment variable (for OpenAI only)
  • Ollama running locally (for --local mode)
Output

Analysis saves alongside transcript as transcript_name_analysis.md:

# Transcript Analysis

**Source Transcript:** path/to/transcript.md
**Analysis Model:** gpt-4o-mini (OpenAI)
**Tokens Used:** 33,763

---

[Analysis content]

Common Workflows

Full Pipeline: URL to Insights (Cloud)
python3 scripts/transcribe.py "https://youtube.com/watch?v=abc123"
python3 scripts/analyze_transcript.py whisper-transcriptions/watch.md
Full Pipeline: URL to Insights (Local)
python3 scripts/transcribe.py "https://youtube.com/watch?v=abc123"
python3 scripts/analyze_transcript.py whisper-transcriptions/watch.md --local
Multiple Analyses on Same Transcript
python3 scripts/analyze_transcript.py transcript.md --output summary.md
python3 scripts/analyze_transcript.py transcript.md --prompt "List action items" --output actions.md
python3 scripts/analyze_transcript.py transcript.md --prompt "Extract quotes" --output quotes.md
Batch Transcription
python3 scripts/transcribe.py "URL1"
python3 scripts/transcribe.py "URL2"
python3 scripts/transcribe.py "URL3"

Reference Files

Troubleshooting (references/troubleshooting.md)
  • Download failures
  • Transcription errors
  • Dependency issues
  • API errors
Configuration (references/configuration.md)
  • Output format details
  • File naming behavior
  • Model selection guidance
Usage Patterns (references/usage-patterns.md)
  • Common transcription scenarios
  • Analysis patterns
  • Batch processing tips

Scripts

ScriptPurpose
scripts/transcribe.pyDownload and transcribe audio/video from URLs (WhisperKit)
scripts/analyze_transcript.pyAI analysis of transcript files (OpenAI or Ollama)

Comments

Markdown supported