pr-screenshots

Capture, host, and embed screenshots in GitHub PR descriptions.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/barichter/squad --skill pr-screenshots-barichter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-screenshots
Source: https://github.com/barichter/squad/tree/main/.squad/skills/pr-screenshots
Command: npx skills add https://github.com/barichter/squad --skill pr-screenshots-barichter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, gh, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This skill solves the issue of reviewers needing to see visual changes in pull requests without checking out the branch, by automatically embedding screenshots in PR descriptions.

Core Features & Use Cases

  • Automated Screenshot Capture: Captures screenshots using Playwright or existing test screenshots.
  • Temporary Branch Hosting: Uploads screenshots to a temporary branch to generate URLs for PR descriptions.
  • Markdown Embedding: Embeds screenshots in PR descriptions for easy review.
  • Cleanup After Merge: Deletes temporary branch after PR is merged.
  • Use Cases: Ideal for PRs with UI/UX changes, documentation updates, and visual artifacts.

Quick Start

Use the pr-screenshots skill to create screenshots for your pull request and embed them automatically in the PR description.

Frequently Asked Questions about pr-screenshots

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

FAQPage Schema
How do I embed screenshots in a GitHub pull request description?

To embed screenshots in a GitHub pull request description, you can automate the process by capturing images with Playwright, hosting them on a temporary branch to generate URLs, and inserting those links into the PR markdown. This allows reviewers to see visual changes without checking out the branch.

Can I use Playwright screenshots for automated PR image embedding?

Yes, you can use Playwright for automated PR image embedding. The skill captures screenshots using Playwright, uploads them to a temporary GitHub branch to generate accessible URLs, and embeds those image links directly into the pull request description markdown for visual review.

Do I need the GitHub CLI to automate PR screenshot hosting?

Yes, you need the GitHub CLI installed to automate PR screenshot hosting. The skill relies on the GitHub CLI to manage temporary branches, upload captured screenshot assets, and generate raw URLs for embedding the images into the pull request description.

What is the best way to show UI changes in a pull request without branch checkout?

The best way to show UI changes in a pull request without branch checkout is to embed screenshots directly in the PR description. This approach captures visual artifacts, hosts them on a temporary branch, and inserts the image URLs into the markdown for immediate reviewer access.

How does temporary branch cleanup work after a PR is merged?

Temporary branch cleanup after a PR is merged involves automatically deleting the branch used to host the embedded screenshots. Once the pull request is merged, the temporary branch is removed to prevent repository clutter while keeping the image links active in the PR history.

What are the limitations of hosting PR screenshots on a temporary branch?

A limitation of hosting PR screenshots on a temporary branch is that the branch must be managed carefully to avoid clutter, requiring cleanup after the pull request is merged. Additionally, this workflow depends on both Playwright and the GitHub CLI being properly configured in the environment.