local-transcript

Solid

Transcribe a specified local video or audio file into cleaned final `.txt`, `.pdf`, or `.docx` transcripts using speech recognition with Apple Silicon GPU acceleration and LLM-based proofreading. Use when the user wants text extracted from a local media file path such as `.mp4`, `.mov`, `.mkv`, `.webm`, `.mp3`, `.m4a`, or `.wav`, and the output language should follow the spoken language in the media automatically. Prefer this skill for local-file transcription workflows that should produce cleaned transcripts with natural paragraphs, LLM-corrected Chinese text, and simplified Chinese output for Chinese speech.

AI & Automation 27 stars 5 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 85/100

Stars 20%
48
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Local Transcript ## Overview Use this skill to turn a local media file into cleaned final transcript files in `.txt`, `.pdf`, or `.docx` format. Extract audio with `ffmpeg`, transcribe with `mlx-whisper` (Apple Silicon GPU) or `faster-whisper` (CPU fallback), then clean and proofread the transcript using a two-layer correction pipeline — deterministic replacements for known ASR bugs, then LLM-based contextual proofreading for domain-specific and semantic errors. ## Workflow 1. Validate the input path. 2. Confirm the requested output format. 3. Check dependencies. 4. Resolve the ASR mode: `fast`, `balanced`, or `accurate`. 5. Reuse cached audio/raw transcript/clean transcript layers when available. 6. Extract or reuse 16 kHz mono WAV audio. 7. Transcribe with the selected ASR backend (language auto-detected or user-specified via `--language`). 8. Clean the transcript: simplified Chinese → deterministic replacements → LLM proofreading → post-LLM safety replacements. 9. Paragraphize and write the requested final file(s). ## Format Resolution Gate - If the user explicitly requests `txt`, `pdf`, or `word/docx`, use that format directly. - If the user requests multiple formats, generate all requested formats from the same cleaned transcript. - If the user asks to transcribe a file but does not specify an output format, ask a short follow-up question before execution: `Which output format do you want: txt, pdf, or docx?` - Do not guess the output format from context alone wh...

Details

Author
johnqtcg
Repository
johnqtcg/awesome-skills
Created
4 months ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category