Transcript Critic

transcript-critic

A [Claude Code Skill](https://code.claude.com/docs/en/skills) that transcribes audio files or YouTube videos using [whisper.cpp](https://github.com/ggerganov/whisper.cpp) and then generates a structured, critical analysis of the transcript -- all from a single slash command.

Run `/transcribe` followed by a `.vtt` file, an audio file, or a URL (including YouTube and other `yt-dlp` supported sites) and Claude will handle the rest: downloading, converting, transcribing, and producing a detailed markdown summary.

---

[Prerequisites](#prerequisites) | [Installation](#installation) | [Usage](#usage) | [How it works](#how-it-works) | [Transcript summary prompt](#transcript-summary-prompt) | [Permissions](#permissions) | [Personal Project Disclosure](#personal-project-disclosure)

---

Disclaimer

This software was developed with the assistance of AI (Anthropic Claude). It is provided "as is", without warranty of any kind, express or implied. **Use at your own risk.** The author assumes no liability for any damages arising from its use.

Prerequisites

Tool	Purpose
whisper.cpp	Local speech-to-text transcription engine
ffmpeg	Audio format conversion
yt-dlp	Downloading audio from YouTube and other sites
Claude Code	CLI for Claude that supports custom skills
Python 3	Used by the install script to update Claude Code settings

Installation

1. Install the skill

Run the install script from the root of this repository:

./install.sh

This will:

• Copy SKILL.md into Claude Code's global skills directory (~/.claude/skills/transcribe/).
• Add a permission rule to ~/.claude/settings.json so that /transcribe can read files from this repository (e.g., ANALYSIS_PROMPT.md) without prompting.

[!Note] If you prefer