pr-walkthrough — Claude Code skill: what it does, how to install
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.
no license 226 installs ★ 51,527 updated 2026-10-24
npx skills add tldraw/tldraw --skill pr-walkthrough -a claude-codeWhat pr-walkthrough 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.
What it helps with
- 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 for the agent
- Create a walkthrough video for PR 7924
- Generate a PR video walkthrough from https://github.com/tldraw/tldraw/pull/7924
How to install pr-walkthrough
1Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill pr-walkthrough -a claude-code2Manually: put the files in place
~/.claude/skills/pr-walkthrough/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pr-walkthrough/
1Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill pr-walkthrough -a codex2Manually: put the files in place
.agents/skills/pr-walkthrough/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill pr-walkthrough -a cursor2Manually: put the files in place
.cursor/skills/pr-walkthrough/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tldraw/tldraw skills/pr-walkthrough2Manually: put the files in place
.github/skills/pr-walkthrough/SKILL.md1Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill pr-walkthrough -a gemini-cli2Platform CLI
gemini skills install https://github.com/tldraw/tldraw --path skills/pr-walkthroughManually: put the files in place
.devin/skills/pr-walkthrough/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tldraw/tldraw --skill pr-walkthrough -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pr-walkthrough
How to install pr-walkthrough in Claude Code?
Run npx skills add tldraw/tldraw --skill pr-walkthrough -a claude-code. The skill file will be stored at ~/.claude/skills/pr-walkthrough/SKILL.md.
What dependencies does pr-walkthrough require?
You need ffmpeg and ffprobe on your system, plus a GEMINI_API_KEY defined in .env. Python scripts in the workflow require no extra pip packages.
What output format does pr-walkthrough produce?
It outputs an MP4 video at 1280×720 (30 fps) inside out/pr-<number>-walkthrough.mp4. The video includes code slides, Gemini TTS audio, and timed subtitles.