pr-to-video

Converts GitHub pull requests into narrated code-change explainer videos rendered as MP4.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Explaining what changed in a pull request to teammates, users, or stakeholders usually means writing release notes or recording a manual walkthrough. This Skill automates that by reading a PR's diff, commits, and contributors via the GitHub CLI and producing a frame-by-frame explainer video with narration, captions, music, and a rendered MP4. ## Core Features & Use Cases - Deterministic PR ingestion: Fetches PR metadata and the full diff with gh (paginated so large PRs don't truncate), resolves shipped versions for merged PRs, and downloads contributor avatars for a credits close. - Storyboard-driven production: Plans the video as a changelog, feature-reveal, fix-explainer, or refactor-walkthrough archetype, then builds each frame as an HTML composition using a fixed code-editorial design system with real diff hunks. - Full audio and render pipeline: Generates TTS narration with word timings, retrieves background music, fetches SFX, builds captions, assembles the timeline, and renders the final MP4 after lint/check validation. - Use Case: A maintainer merges a large feature PR and runs the Skill on owner/repo#1842 to get a narrated 60-second video walking through the key diff hunks, ending with a contributor credits card citing the shipped version. ## Quick Start Turn the pull request at this GitHub URL into a narrated code-change explainer video and render it to an MP4.

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 for the current PR. The Skill fetches the diff and commits with the gh CLI, plans a storyboard, builds HTML frames, adds narration and music, and renders an MP4.

What kinds of pull request videos can it generate?▼

It supports four PR archetypes: changelog, feature reveal, fix explainer, and refactor walkthrough. Each uses PR-native frame types and features two to four real diff hunks rendered as legible code snippets on a code-editorial surface.

Does it work with large pull requests with many files?▼

Yes. The fetch script completes the files list through paginated gh api calls, so a large PR does not truncate at roughly 100 files. Only pr.json and diff.patch are written, with no scratch directory.

Can it make a video without narration or music?▼

Yes. Setting music: none in the storyboard frontmatter with no SCRIPT.md marks the project fully silent, and the audio step generates nothing. Narration with BGM turned off is also supported.

What happens if the GitHub CLI cannot access the PR?▼

The fetch script exits with an error on gh auth failures, not-found, or private repositories, and the workflow stops rather than fabricating PR contents. You must fix authentication or access before continuing.

When should I not use this for video creation?▼

It is not suited for product promos from a live website or topic explainers without a pull request. Those intents route to the product-launch-video or faceless-explainer skills instead, since this workflow has no website capture step.