puntorigen/avatar-skills / video-transcribe
video-transcribe
VerifiedDownload a single video by URL (Instagram reel/post, or any yt-dlp-supported link) and transcribe its spoken audio to text with faster-whisper — or transcribe a local media file. Writes plain text, an SRT subtitle file, and a JSON with per-segment timecodes. Uses yt-dlp for download and faster-whisper (default `small`, CPU/int8) for transcription. Use when the user wants the spoken text / transcript / subtitles of an Instagram reel or other video, wants to turn a reel's audio into a script, or wants to transcribe a local audio/video file.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.4 KB |
| examples.md | markdown | 1.5 KB |
| requirements.txt | manifest | 210 B |
| scripts/transcribe.py | script | 6.3 KB |
examples.md
View on GitHub# video-transcribe — examples
## 1. Instagram reel → transcript (the original use case)
```bash
python3 .cursor/skills/video-transcribe/scripts/transcribe.py \
"https://www.instagram.com/reels/DZScDIDNTi7/" \
--output-dir reference-reels/DZScDIDNTi7 --language es
```
Produces:
```
reference-reels/DZScDIDNTi7/
├── transcript.mp4 # the downloaded reel
├── transcript.txt # full spoken text
├── transcript.srt # subtitles with timecodes
└── transcript.json # language, duration, model, per-segment timecodes
```
stdout (after the run) prints the text, e.g.:
```
lang=es (1.00) dur=44.6s model=small
============================================================
Vas a estar bien. No. Escúchame de verdad. Vas a estar bien. ...
```
## 2. Local file (already downloaded)
```bash
python3 .cursor/skills/video-transcribe/scripts/transcribe.py lolo/videos/2026-06-08_15-02-03.mp4
```
Outputs land next to the file as `2026-06-08_15-02-03.txt/.srt/.json`.
## 3. Higher accuracy, custom name, drop the video
```bash
python3 .cursor/skills/video-transcribe/scripts/transcribe.py \
"https://www.instagram.com/reel/XXXX/" \
--output-dir out --basename eva_vas_a_estar_bien \
--model large-v3 --language es --cleanup
```
`--cleanup` deletes the downloaded mp4 after writing the transcript files.
## Tip: feed the transcript into a reel
The `.txt` is a ready starting point for a script. Adapt it to an avatar's voice
and structure, then build the reel with `avatar-reel-composer` (see that skill).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |