auto-editor-transcribe
Transcribe a media file or live microphone to text or subtitles with auto-editor's whisper subcommand, then edit by spoken content — cut to keep (or drop) sections whose subtitles match a word or regex. Use when someone wants a transcript, captions, live speech transcription, or to cut a video based on what is said rather than on loudness.
- Installs
- 695
- Last 24h
- +24
- Trending rank
- #5000
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/wyattblue/auto-editor --skill auto-editor-transcribe- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads auto-editor-transcribe automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Transcribe & edit by speech
Use auto-editor's whisper.cpp (Whisper or NVIDIA Parakeet models) or Apple Speech backend to transcribe audio. Cut a timeline based on subtitle content with --edit subtitle/word.
Transcribe — auto-editor whisper
auto-editor whisper <file|:mic> <model> [options]
Set <model> to a ggml model path. Three backends, chosen by the model:
- Whisper:
ggml-small.en.bin,ggml-medium.en.bin,ggml-large-v3.bin, … (https://huggingface.co/ggerganov/whisper.cpp). 99+ languages,--translate,--prompt. - Parakeet: any model with "parakeet" in the filename, e.g.
ggml-parakeet-tdt-0.6b-v3-q8_0.bin(https://huggingface.co/ggml-org/parakeet-GGUF). Faster than Whisper at comparable English accuracy; language is auto-detected.--translate,--prompt, and--languageare rejected. - Apple: the magic model name
appleuses Apple's built-in transcriber; requires macOS 26 or later.
Only the first audio stream of a file is used. Audio is resampled to 16 kHz, and text prints to stdout by default.
auto-editor whisper example.mp4 ggml-medium.en.bin # plain text → stdout
auto-editor whisper example.mp4 ggml-medium.en.bin --format srt -o out.srt
auto-editor whisper example.mp4 ggml-parakeet-tdt-0.6b-v3-q8_0.bin # parakeet backend
auto-editor whisper example.mp4 apple --language en_US # macOS 26+
Options: --format text|srt|json, -o/--output FILE, -l/--language en
(default auto), -tr/--translate (→ English), -sw/--split-words (one word per
cue), --queue SECS (default 30), --prompt TEXT, --threads N (default 4),
and -t/--threshold THRES (default 0.04).
--split-words works with on all backends. Parakeet is the most accurate.
With the apple model, set --language to a supported language or locale.
Apple speech cannot auto-detect language, so auto falls back to en_US with a
warning. Do not pass --translate or --prompt; neither is supported. The first
use of a language may download Apple's speech model and therefore needs network
access.
Transcribe a live microphone
Pass :mic instead of a file. Stop capture gracefully with Ctrl-C.
auto-editor whisper :mic ggml-medium.en.bin
auto-editor whisper :mic apple --language en_US # macOS 26+
auto-editor whisper :mic ggml-medium.en.bin -o transcript.srt
This streams the microphone directly to transcription and does not save a
media recording. To retain and edit the captured audio, use auto-editor :mic;
editor and timeline exports save a sibling lossless-FLAC _RECORDING.mka by
default.
Live capture supports macOS, Windows, and Linux:
- macOS uses AVFoundation and prefers a USB microphone, then the system default.
- Windows uses DirectShow and prefers a USB microphone, then the first audio capture device.
- Linux uses the default ALSA input device.
When -o/--output ends in .srt, .json, .txt, or .text, the output format is
inferred unless --format is set explicitly.
Edit by spoken content
--edit subtitle/word marks the time a matching subtitle line occupies as
active (kept by default). Use an existing subtitle stream, or transcribe to
an .srt first and feed it in.
| Method | Active when… | Args (defaults) |
|---|---|---|
subtitle / regex | pattern (regex) matches a line | pattern="" (empty matches every line), stream=0, ignore-case=#f |
word | value appears as a whole word | value required, stream=0, ignore-case=#t |
pattern is optional for subtitle/regex: with none, the empty regex matches
every subtitle line, so --edit subtitle keeps all sections that have a subtitle
(i.e. cut everything with no speech). word, by contrast, requires a value.
# Keep only sections that have any subtitle (cut the silent gaps between speech)
auto-editor talk.mkv --edit subtitle
# Keep only sections where "introduction" is spoken
auto-editor lecture.mp4 --edit word:introduction
# Regex match (case-insensitive); keep matched lines
auto-editor talk.mkv --edit "subtitle:pattern=(yes|no),ignore-case=#t"
# Cut filler words instead of keeping them: invert with `not`
auto-editor video.mp4 --edit "(not word:um)"
Transcribe → cut workflow
When the media has no subtitle stream, generate a sidecar named after the
input — for talk.mp4, auto-editor auto-loads talk.srt (then talk.ass) when
the requested subtitle stream isn't embedded:
auto-editor whisper talk.mp4 ggml-medium.en.bin --format srt -o talk.srt
auto-editor talk.mp4 --edit word:question # picks up talk.srt automatically
Inspect subtitle streams with auto-editor subdump FILE (text subtitles only;
bitmap subtitles won't dump).
For loudness/motion-based cutting and pace, see the auto-editor skill.
FAQ
What does the auto-editor-transcribe skill do?
Transcribe a media file or live microphone to text or subtitles with auto-editor's whisper subcommand, then edit by spoken content — cut to keep (or drop) sections whose subtitles match a word or regex. Use when someone wants a transcript, captions, live speech transcription, or to cut a video based on what is said rather than on loudness.
How do I install auto-editor-transcribe?
Run npx skills add https://github.com/wyattblue/auto-editor --skill auto-editor-transcribe in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/auto-editor-transcribe/ (personal) or .claude/skills/auto-editor-transcribe/ (project).
Which AI agents can use auto-editor-transcribe?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is auto-editor-transcribe safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains auto-editor-transcribe?
It is published by wyattblue in wyattblue/auto-editor. It has 695 recorded installs.
More from wyattblue/auto-editor
auto-editor
wyattblue/auto-editor
Record a microphone or edit video/audio with the auto-editor CLI — cut out dead space (silence, motionlessness, black frames), set the pace, make manual cuts, and render the result. Use when someone wants to capture and trim a microphone, remove silence, shorten a recording, speed through quiet parts, or otherwise edit media with auto-editor.
auto-editor-export
wyattblue/auto-editor
Export auto-editor's edit or microphone recording to a video editor (Premiere, DaVinci Resolve, Final Cut Pro, ShotCut, Kdenlive), to individual clips, or to auto-editor timeline files (.v1/.v2/.v3); and import timeline/XML files to render them. Use when someone wants an editor-ready project, a preserved microphone source, split clips, or timeline files instead of a finished video.
auto-editor-effects
wyattblue/auto-editor
Apply actions and animations to sections of a video/audio with auto-editor — change speed, duck or fade volume, de-ess, zoom/Ken Burns, rotate/spin, draw boxes, overlay logos or picture-in-picture, and animate any of these with ramps and easing. Use when someone wants creative effects or per-section behavior rather than plain silence-cutting.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image