pr-to-video

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

1|Updated Jan 10, 2024
One-click install
npx skills add https://github.com/noemdb/cfla --skill pr-to-video-noemdb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-to-video
Source: https://github.com/noemdb/cfla/tree/main/.agents/skills/pr-to-video
Command: npx skills add https://github.com/noemdb/cfla --skill pr-to-video-noemdb

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Turning a merged or proposed code change into a clear video explanation normally requires manual screen recording, editing, and narration work. This Skill automates that pipeline: it ingests a GitHub pull request, plans a storyboard from the diff, and renders a finished MP4 explainer. ## Core Features & Use Cases - Deterministic PR ingestion: Fetches PR metadata, the full diff (paginated for large PRs), and contributor avatars using the GitHub CLI, with no website capture step. - Storyboard and script generation: Plans a changelog, feature-reveal, fix-explainer, or refactor-walkthrough narrative with real diff hunks, then generates narration, word timings, BGM, and SFX. - Frame building and rendering: Dispatches bounded frame workers to build HTML compositions, assembles captions and transitions, and renders the final video via the HyperFrames CLI. - Use Case: Given a PR URL like owner/repo#1842, produce a narrated 1080p video walking reviewers or users through what changed, with code-diff visuals and a contributor credits close. ## Quick Start Turn this GitHub pull request into a short explainer video using the pr-to-video skill.

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 metadata with the gh CLI, plans a storyboard, generates narration and music, and renders an MP4 through HyperFrames.

What input formats does the PR to video workflow accept?▼

It accepts a full GitHub PR URL, a shorthand owner/repo#N reference, or a bare PR number inside a checked-out repository. The input must be a code change; websites or general topics route to other HyperFrames skills.

Does the PR video generator work with large pull requests?▼

Yes. The fetch script paginates the GitHub API so PRs with more than about 100 changed files are not truncated. The storyboard then features only 2-4 representative diff hunks, each capped at 12 lines per frame.

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 marker, generates nothing, and the assembler treats the project as fully silent.

Why does PR ingestion fail with a gh error?▼

Ingestion exits when the GitHub CLI is unauthenticated, the PR is not found, or the repository is private without access. Authenticate gh and verify the PR reference; the skill never fabricates PR contents after a fetch failure.

What video formats and sizes can it render?▼

It renders MP4 in landscape 1920x1080, portrait 1080x1920, or square 1080x1080, derived from the destination in the brief. The format is set once in the storyboard frontmatter before frames are built.