# pr-walkthrough

pr-walkthrough generates an MP4 walkthrough video of a GitHub pull request with code slides, voiceover, and subtitles. It helps teammates grasp complex code changes fast.

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

## What it does

It takes a pull request URL. The skill reviews commit history and diffs while skipping generated files like lockfiles and API reports. The assistant then drafts a continuous narration from the author's viewpoint, splitting code changes into clear segments.

Speech is generated per segment using `gemini-3.1-flash-tts-preview` through `./scripts/generate-audio.sh`. A manifest aligns slide durations before `./video/render.sh` builds the 1280×720 MP4 file at 30 fps. Whisper transcribes the speech to render yellow-on-black subtitles.

Rendering halts without `ffmpeg`, `ffprobe`, and a valid `GEMINI_API_KEY` inside `.env`. Python standard library suffices for all helper scripts.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill pr-walkthrough -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill pr-walkthrough -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill pr-walkthrough -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tldraw/tldraw skills/pr-walkthrough
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill pr-walkthrough -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tldraw/tldraw --path skills/pr-walkthrough
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill pr-walkthrough -a opencode
```

### 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/tldraw/tldraw/tree/HEAD/skills/pr-walkthrough/SKILL.md

## When to use it
- produce a narrated video walkthrough for a pull request
- filter out generated API reports and lockfiles during code reviews
- generate segment-by-segment TTS audio for diff slides
- render subtitles automatically via Whisper transcription

## Example prompts
- Create a walkthrough video for PR 7924
- Generate a PR video walkthrough from https://github.com/tldraw/tldraw/pull/7924

## Similar
- [review-walkthrough](https://affpapa.org/en/nevibecode/skills/clhbid-review-walkthrough.md) — skill · 536 installs
- [bmad-walkthrough](https://affpapa.org/en/nevibecode/skills/bmad-walkthrough.md) — skill · 17000 installs
- [video-translation](https://affpapa.org/en/nevibecode/skills/video-translation.md) — skill · 2100 installs
- [text-to-speech](https://affpapa.org/en/nevibecode/skills/benchflow-ai-text-to-speech.md) — skill · 4 installs
- [printfilm](https://affpapa.org/en/nevibecode/skills/printfilm.md) — skill · ★ 4967 repo stars
- [paper-reel](https://affpapa.org/en/nevibecode/skills/paper-reel.md) — skill · ★ 149 repo stars

From the same set: [tldraw/tldraw](https://affpapa.org/en/nevibecode/by/tldraw/tldraw.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
