Skip to content

puntorigen/avatar-skills / video-transcribe

video-transcribe

Verified

Download 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.

FileKindSize
SKILL.mdskill md4.4 KB
examples.mdmarkdown1.5 KB
requirements.txtmanifest210 B
scripts/transcribe.pyscript6.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).
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall