local-transcript

Transcribe local media files into txt, pdf, or docx transcripts.

29|5|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/johnqtcg/awesome-skills --skill local-transcript-johnqtcg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-transcript
Source: https://github.com/johnqtcg/awesome-skills/tree/main/skills/local-transcript
Command: npx skills add https://github.com/johnqtcg/awesome-skills --skill local-transcript-johnqtcg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mlx-whisper, mlx-lm, faster-whisper, opencc-python-reimplemented, python-docx, reportlab, and includes scripts (resource) components.

What problem does it solve?

Transcribe local video or audio files into cleaned final transcripts in .txt, .pdf, or .docx, with language auto-detection and LLM-assisted proofreading to ensure natural paragraphs and Chinese output when the source is Chinese.

Core Features & Use Cases

  • Audio extraction from local media using ffmpeg and transcription via mlx-whisper (Apple Silicon GPU) or faster-whisper (CPU fallback).
  • Deterministic corrections for common ASR errors, followed by LLM-based proofreading for domain terms and proper nouns, with optional language-specific proofreading.
  • Multi-format final deliverables (txt, pdf, docx) and caching to accelerate repeated runs on the same media.

Quick Start

Run the local-transcript script on a local media file to generate final transcripts in txt, pdf, or docx.

Frequently Asked Questions about local-transcript

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

FAQPage Schema
How do I transcribe local media files into a polished transcript?

Transcribing local media files into a polished transcript involves running a pipeline that extracts audio using ffmpeg, transcribes via mlx-whisper or faster-whisper, and applies LLM proofreading. It supports txt, pdf, and docx outputs with language auto-detection.

Can I use faster-whisper for transcription on a CPU without Apple Silicon?

Yes, you can use faster-whisper for transcription on a CPU without Apple Silicon as it serves as a fallback backend. The pipeline automatically defaults to mlx-whisper for Apple Silicon GPU acceleration but switches to faster-whisper when GPU hardware is unavailable.

What is the best way to generate Chinese transcripts from local video?

The best way to generate Chinese transcripts from local video is using a pipeline with language auto-detection and LLM-assisted proofreading. It ensures natural paragraph formatting and matches the spoken language, specifically producing Chinese output when the source audio is Chinese.

Does local-transcript support exporting to docx and pdf formats?

Yes, local-transcript supports exporting to docx and pdf formats, alongside txt. The pipeline generates these multi-format final deliverables directly from the transcribed media using python-docx and reportlab, providing cleaned transcripts for immediate downstream use.

Why do ASR transcriptions of domain terms and proper nouns contain errors?

ASR transcriptions contain errors in domain terms and proper nouns due to speech recognition limitations. The pipeline corrects these by applying deterministic fixes for common ASR errors, followed by LLM-based proofreading to ensure quality, consistency, and accurate terminology.

How does caching accelerate repeated transcription runs on the same media?

Caching accelerates repeated transcription runs on the same media by storing intermediate processing results. This prevents redundant audio extraction and ASR transcription, allowing the pipeline to quickly retrieve cached data and output the final polished transcripts for repeated analysis.