# captions

Captions is a Claude Code skill that cleans verbatim transcripts by removing stutters and fillers. It triggers when preparing SRT files for DaVinci Resolve.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 470 repo stars
- Author: appariciojunior
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/appariciojunior/video-editor-skills/tree/HEAD/skills/captions/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/appariciojunior-captions

## What it does

The tool processes raw transcripts into formatted, readable subtitle lines. It filters out speech disfluencies, corrects colloquial grammar, keeps lines under 42 characters, and verifies proper nouns. It relies on global configuration rules supplemented by video-specific adjustments in `caption_fixes.json`.

Every line is reviewed before final file generation to catch punctuation errors or missing words. Users should define the existing subtitle style from their project timeline to maintain consistency in the output.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add appariciojunior/video-editor-skills --skill captions -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/captions/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/captions/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add appariciojunior/video-editor-skills --skill captions -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/captions/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add appariciojunior/video-editor-skills --skill captions -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/captions/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install appariciojunior/video-editor-skills skills/captions
```

2. **Manually: put the files in place**
- File: `.github/skills/captions/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add appariciojunior/video-editor-skills --skill captions -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/appariciojunior/video-editor-skills --path skills/captions
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/captions/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/appariciojunior/video-editor-skills/tree/HEAD/skills/captions/SKILL.md

## When to use it
- Remove speech fillers and stutters
- Format text into 42-character lines
- Correct colloquial grammar
- Align subtitle timing with video cuts

## Example prompts
- Generate SRT subtitles for this video using `caption_fixes.json`.
- Clean up the transcript and format it for DaVinci Resolve using captions.

## Similar
- [captions-media-accessibility](https://affpapa.org/en/nevibecode/skills/captions-media-accessibility.md) — skill · 195 installs
- [video-transcription](https://affpapa.org/en/nevibecode/skills/video-transcription.md) — skill · 1300 installs
- [import-srt-captions](https://affpapa.org/en/nevibecode/rules/import-srt-captions.md) — rule · ★ 849 repo stars
- [subtitle-generation](https://affpapa.org/en/nevibecode/skills/subtitle-generation.md) — skill · 832 installs
- [ffmpeg-captions-subtitles](https://affpapa.org/en/nevibecode/skills/ffmpeg-captions-subtitles.md) — skill · 634 installs
- [transcribe-video](https://affpapa.org/en/nevibecode/skills/transcribe-video.md) — skill · ★ 32 repo stars

## Other versions with the same name
- [captions · zeropointrepo](https://affpapa.org/en/nevibecode/skills/captions.md) — 789 installs

From the same set: [appariciojunior/video-editor-skills](https://affpapa.org/en/nevibecode/by/appariciojunior/video-editor-skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
