update-screenshots

Download CI screenshot artifacts and replace component baselines via GitHub Actions.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/aadorian/VSCode_Readme --skill update-screenshots-aadorian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-screenshots
Source: https://github.com/aadorian/VSCode_Readme/tree/main/education/engineering-tooling/github/copilot-skills/update-screenshots
Command: npx skills add https://github.com/aadorian/VSCode_Readme --skill update-screenshots-aadorian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual friction of accepting screenshot changes locally by using the latest CI-produced baselines as the source of truth. It is especially useful when platform differences like fonts, rendering, or DPI make local screenshots diverge from GitHub Actions results.

Core Features & Use Cases

  • CI Baseline Sync: Downloads the newest screenshot-diff artifact from a failed screenshot test run.
  • Diff Review: Surfaces the markdown report so you can inspect exactly what changed before accepting it.
  • Baseline Replacement: Replaces the repository’s component screenshot baselines with the CI-generated images and prepares them for commit.
  • Git LFS Safety: Includes the required LFS push workflow so large screenshot assets can be published successfully.
  • Use Case: A component test fails in CI with screenshot mismatches, and you need to accept the updated visuals without introducing local rendering noise.

Quick Start

Use this skill to download the latest CI screenshot diff, review the changes, and update the baseline images in the repository.

Frequently Asked Questions about update-screenshots

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

FAQPage Schema
How do I update screenshot baselines from a GitHub Actions CI artifact?

To update screenshot baselines from a CI artifact, download the newest screenshot-diff artifact using an authenticated gh CLI, review the markdown diff report, replace the repository baselines, and commit the changes with Git LFS handling.

Why do my local screenshot tests fail in CI but pass locally?

Local screenshot tests often fail in CI due to platform differences like fonts, rendering, or DPI. Syncing baseline images directly from the GitHub Actions artifact removes this local rendering noise by using the CI-generated images as the source of truth.

What do I need to download and accept screenshot diffs from GitHub Actions?

You need an authenticated GitHub CLI, access to the screenshot-diff CI artifact, and Git LFS-aware commit and push handling to successfully download, review, and replace component fixture screenshot baselines.

How do I safely commit and push large screenshot baseline files updated from CI?

To safely commit and push large screenshot baseline files updated from CI, use a Git LFS-aware workflow that includes the required LFS push handling to ensure the refreshed screenshot assets are published successfully to the repository.

Can I review what changed in my screenshot test failures before accepting new baselines?

Yes, you can review what changed in screenshot test failures before accepting new baselines. The workflow surfaces the markdown diff report from the CI artifact so you can inspect exactly what visual changes occurred.

Does this screenshot baseline refresh workflow require Git LFS?

Git LFS is required if your repository stores large screenshot assets. The workflow includes the required LFS push handling to ensure that baseline image replacements and commits are published successfully without hitting file size limitations.