pr-to-video

Converts GitHub pull requests into narrated code-change explainer videos via HyperFrames.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/celeroncoder/skills --skill pr-to-video-celeroncoder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-to-video
Source: https://github.com/celeroncoder/skills/tree/main/pr-to-video
Command: npx skills add https://github.com/celeroncoder/skills --skill pr-to-video-celeroncoder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Turning a merged pull request into a clear video explanation of what changed normally requires manual screen recording, scripting, and editing; this Skill automates that pipeline from PR URL to rendered MP4. ## Core Features & Use Cases - Deterministic PR ingestion: Fetches the PR's metadata, full diff, and contributor list via the GitHub CLI, including paginated file lists for large PRs and shipped-version detection for merged PRs. - Storyboard and script generation: Plans a changelog, feature-reveal, fix-explainer, or refactor-walkthrough narrative with real diff hunks, then generates TTS narration, background music, and captions. - Frame-by-frame video assembly: Builds HTML frame compositions on a code-editorial design system, assembles them into a timeline, and renders a final MP4 with a contact sheet for review. - Use Case: Paste a PR URL like owner/repo#1842 and receive a narrated walkthrough video highlighting the key diff hunks, with a credits close showing contributor avatars. ## Quick Start Turn this GitHub pull request into a short explainer video: https://github.com/owner/repo/pull/123.

Frequently Asked Questions about pr-to-video

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a GitHub pull request into a video?▼

Provide a PR URL, an owner/repo#N reference, or run it in a checked-out repo with 'this PR'. The skill fetches the diff and commits via the gh CLI, plans a storyboard, generates narration and music, builds HTML frames, and renders an MP4.

What tools are required to generate a PR explainer video?▼

You need the GitHub CLI (gh) authenticated for PR access, the HyperFrames CLI for project init, preview, and rendering, and either a HeyGen sign-in or local engines like Kokoro for text-to-speech and background music.

Can it handle large pull requests with many changed files?▼

Yes. The fetch script completes the files list through paginated gh api calls so large PRs do not truncate at roughly 100 files, and the storyboard features only 2-4 representative diff hunks selected for narrative clarity.

Does it work for private repositories or when gh is not authenticated?▼

No. If the gh CLI returns an auth, not-found, or private-repository error, the fetch step exits with an error and the workflow stops rather than fabricating PR contents. Authenticate gh with access to the repository first.

When should I not use this skill for a video?▼

Do not use it for product promo videos without a code change or for general topic explainers with no PR; those route to the product-launch-video or faceless-explainer skills instead. The input must be an actual GitHub pull request.