Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tldraw/tldraw --skill pr-walkthrough -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/pr-walkthrough/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pr-walkthrough/

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.

Similar skills

All skills for Code review and refactoring →

From the same set12

The whole set →
write-e2e-tests write-e2e-tests guides Playwright E2E testing for tldraw, including UI actions, menus, and canvas shapes. Use it when adding coverage for SDK examples or the tldraw.com client. CX Codex +1 437installs write-pr write-pr sets PR title and description standards: semantic types, structured templates, and reviewer-focused writing rules. CX Codex +1 425installs write-issue write-issue enforces GitHub issue formatting and triage standards based on the tldraw repository. It helps draft clear titles, structure descriptions, and manage labels. CX Codex +1 410installs review-docs review-docs is a Claude Code skill that audits tldraw SDK documentation against style guides and source code. It helps find inaccurate API references and refine articles. CX Codex +1 398installs write-release-notes write-release-notes is a Claude Code skill that creates and reviews tldraw SDK release-note articles from merged PRs, adding migration guidance for breaking changes. CX Codex +1 333installs write-tbp write-tbp guides drafting technical blog posts about tldraw architecture by gathering context straight from editor packages, types, and tests. CX Codex +1 169installs update-release-notes update-release-notes — a skill that maintains the release notes file next.mdx in the tldraw repo: collects PRs since the last release and archives next.mdx to a versioned file when a new version ships. CX Codex +1 ★ 51,527repo stars tldraw Connects an interactive tldraw canvas to an AI agent for drawing, editor actions, and saved canvas state. CX Codex +1 ★ 51,527repo stars

Project sponsors

Companies that keep this analytics open