pr-to-video

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

13|17|Updated Jan 30, 2025
One-click install
npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill pr-to-video-codewithsally
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-to-video
Source: https://github.com/CodeWithSally/CodeWithSally-Apex-English/tree/main/Sessions/ClaudeCode/Session007/.agents/skills/pr-to-video
Command: npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill pr-to-video-codewithsally

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 avatar downloads for a credits close. - Storyboard and script generation: Plans a changelog, feature-reveal, fix-explainer, or refactor-walkthrough narrative with real diff hunks, then generates narration, word timings, background music, and SFX. - Frame-by-frame video assembly: Builds HTML frame compositions on a code-editorial design system, assembles captions and audio tracks, and renders the final MP4 after lint and snapshot checks. - Use Case: Paste a PR URL like owner/repo#1842 and receive a narrated walkthrough video highlighting the key diff hunks, the shipped version, and a contributor credits close. ## Quick Start Turn this pull request into a short explainer video: https://github.com/owner/repo/pull/1842.

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 inputs does the PR to video workflow accept?

It accepts a full GitHub PR URL, an owner/repo#N shorthand, or the phrase 'this PR' inside a checked-out repository. It does not capture websites; the only real assets are contributor avatars used in the credits close.

Does it work with large pull requests with many files?

Yes. The fetch script completes the files list through paginated GitHub API calls so a large PR does not truncate at roughly 100 files, and it writes only pr.json and diff.patch without a scratch directory.

Can I make a silent video without narration or music?

Yes. Set music: none in the storyboard frontmatter and omit SCRIPT.md; the audio step recognizes this as the fully-silent marker and generates nothing, and assembly treats the project as silent.

Why does the workflow stop after fetching the PR fails?

A gh authentication, not-found, or private-repository error exits the fetch step with code 1, and the skill reports stderr and stops rather than fabricating PR contents. Fix the gh auth or repository access and rerun.

When should I not use this skill for a video?

Do not use it for product promos, website walkthroughs, or topic explainers without a pull request; those route to the product-launch-video or faceless-explainer skills instead. This skill's input is strictly a code change.