# Turn a Pull Request into a Video

Pull requests can be difficult to explain to teammates and stakeholders. This skill turns verified PR facts into a structured HyperFrames explainer video.

## Install

```bash
npx skillstore add heygen-com/pr-to-video
```

## Metadata

- Status: approved
- Slug: heygen-com-pr-to-video
- Skillstore revision: r2
- Version status: missing
- Tree hash: eaff6004eabd682a707bd994740e5d5a5cf6360ef4f523784b0d42fbf8c5792d
- Author: heygen-com
- GitHub username: heygen-com
- License: MIT
- Repository: https://github.com/heygen-com/hyperframes/tree/main/skills/pr-to-video/
- Ref: 77d0e66fbadeb1f5d1e6a5aada7861240b8ed2d7
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: network, filesystem, env\_access, external\_commands, scripts
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/heygen-com-pr-to-video
- Manifest: https://skillstore.pages.dev/api/skills/heygen-com-pr-to-video/manifest

## Capabilities

- Fetches pull request metadata, changed files, commits, and diffs through the GitHub CLI.
- Creates a PR-specific project directory outside the caller repository by default.
- Builds a storyboard and narration plan from real pull request evidence.
- Generates frame compositions, captions, transitions, and a final MP4 through HyperFrames.
- Downloads contributor avatars for an optional credits frame.
- Validates video output with HyperFrames lint, check, and snapshots.

## Use Cases

- Explain a release change: Turn a merged pull request into a concise release walkthrough with verified code examples.
- Prepare a code review recap: Create a visual summary of a complex pull request for reviewers and project leads.
- Share a refactor update: Present the purpose and effect of a refactor without reading the full diff aloud.

## Prompt Templates

### Create a basic PR video

```
Create a short explainer video for GitHub PR owner/repo#123. Summarize the main change and ask for approval before rendering.
```

### Explain a bug fix

```
Turn this PR into a bug-fix walkthrough. Focus on the problem, the changed code, and the user impact: https://github.com/owner/repo/pull/123.
```

### Create a release recap

```
Create a release-ready PR video for owner/repo#123. Use a clear changelog structure, include two real diff excerpts, and use a calm narration voice.
```

### Create a silent technical walkthrough

```
Create a silent visual walkthrough for owner/repo#123. Do not generate narration or music. Use captions and code-focused frames, then pause for review before rendering.
```

## Limitations

- Requires GitHub CLI authentication and access to the target pull request.
- Requires HyperFrames and optional media providers for full rendering and audio features.
- Does not capture a product interface or create a marketing video from a website.
- The final render requires user approval after the review checkpoint.

## Best Practices

- Use a pull request URL or owner/repository number that you can access with GitHub CLI.
- Review the storyboard and real diff excerpts before approving a render.
- Use a dedicated project directory for generated assets and video output.

## Anti Patterns

- Do not use this skill for website captures or product marketing videos without a pull request.
- Do not approve a render before checking the storyboard, snapshots, and validation results.
- Do not assume missing GitHub permissions can be bypassed; authenticate and request access instead.

## Security Audit

- Audited at: 2026-07-19T11:13:11.635\+00:00
- Summary: Most static matches are scanner false positives caused by JavaScript regular-expression methods, Markdown code formatting, fixed sibling references, and documented local tooling. A material workflow risk remains: the skill instructs agents to silently fetch and apply remote HyperFrames skill updates before use, allowing reviewed content to change without consent. Static review was capped at 400/822 representative findings; omitted static matches are unconfirmed, so automatic publishing stays disabled until manual review.

## Stats

- Views: 0
- Downloads: 6
- Favorites: 0
- Popularity score: 0