pr-walkthrough

Capture screenshots, browser GIFs, and terminal output into a Pull Request body.

13|3|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/phrazzld/agent-skills --skill pr-walkthrough-phrazzld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-walkthrough
Source: https://github.com/phrazzld/agent-skills/tree/main/core/pr-walkthrough
Command: npx skills add https://github.com/phrazzld/agent-skills --skill pr-walkthrough-phrazzld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the need for manual, prose-heavy walkthroughs by automatically capturing and attaching visual evidence (screenshots, GIFs, terminal output) directly to a Pull Request, proving the merge claim.

Core Features & Use Cases

  • Automated Evidence Capture: Records screenshots, browser GIFs, and terminal output.
  • Direct PR Attachment: Updates the PR body with a ## Reviewer Evidence section, embedding or linking captured artifacts.
  • Use Case: When submitting a PR for a UI change, this Skill captures before/after screenshots and a GIF of the interaction, embedding them into the PR description for immediate reviewer verification.

Quick Start

Use the pr-walkthrough skill to capture evidence for PR number 123.

Frequently Asked Questions about pr-walkthrough

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

FAQPage Schema
How do I add screenshots and terminal output to a PR for visual evidence?

To add visual evidence to a PR, this skill captures screenshots, browser GIFs, and terminal output, then embeds them directly into the PR body using a dedicated Reviewer Evidence section for immediate verification.

What is the best way to automate GitHub PR walkthroughs?

Automating GitHub PR walkthroughs is done by capturing visual artifacts during testing and attaching them directly to the PR description, eliminating the need to manually create separate markdown walkthrough files.

Can I use `gh pr edit` to embed GIFs in a Pull Request?

Yes, you can embed GIFs in a Pull Request using `gh pr edit` and `gh pr comment`. This skill integrates with these GitHub tools to update the PR body with captured browser interactions.

Does this visual evidence capture work with terminal output?

Yes, this visual evidence capture works with terminal output by recording the command line results. It attaches these terminal captures alongside screenshots and browser GIFs directly to your PR body.

Why attach visual artifacts directly to the PR body instead of using markdown files?

Attaching visual artifacts directly to the PR body provides immediate reviewer verification without navigating away. This method replaces prose-heavy markdown walkthrough files with embedded screenshots, GIFs, and terminal output.

What do I need to capture browser GIFs for a UI change PR?

To capture browser GIFs for a UI change PR, you need an environment capable of recording the interaction. The skill automates this capture process and embeds the resulting visual evidence into the PR description.