update-screenshots
microsoft/vscode
Download and commit screenshot baselines from VS Code CI runs after visual changes are detected.
What is update-screenshots?
Manages component screenshot baselines for VS Code by downloading the latest CI artifacts and committing them. Use this when the screenshot-test GitHub Action reports differences or when asked to update, accept, or refresh screenshot baselines. Note: baselines are no longer stored in the repository but managed by an external screenshot service.
- Downloads screenshot artifacts from the latest CI run
- Commits updated baselines to the repository
- Integrates with the screenshot-test GitHub Action workflow
- Handles baseline updates after visual changes are detected
- Works with the external screenshot service (hediet-screenshots.azurewebsites.net)
How to install update-screenshots
npx skills add https://github.com/microsoft/vscode --skill update-screenshots- GitHub CLI (gh) installed and authenticated
- Access to the VS Code repository
- Latest CI run with screenshot artifacts available
How to use update-screenshots
- 1.Run the skill when prompted by screenshot test failures or when asked to update baselines
- 2.The skill downloads the screenshots artifact from the latest CI run using the run ID
- 3.Review the before/after comparisons posted in the PR comment by the CI workflow
- 4.The skill commits the updated baselines to the repository
- 5.After merge to main, the new screenshots become the baselines automatically
Use cases
- Update component screenshot baselines after the screenshot-test GitHub Action reports differences
- Accept visual changes to component screenshots in a PR
- Refresh baselines when component rendering changes are intentional
- Download raw captured screenshots from CI for local comparison
- Commit new baselines after visual regression review
- VS Code contributors managing component visual tests
- Developers reviewing screenshot diffs in CI workflows
- Teams maintaining component screenshot baselines
update-screenshots FAQ
Baselines are no longer stored in the repository. They are managed by an external screenshot service (hediet-screenshots.azurewebsites.net) and keyed by commit SHA.
No. After merge to main, the screenshots from that commit become the new baselines automatically. The CI workflow handles this.
The screenshot-test GitHub Action posts a PR comment with before/after comparisons. You can also download the screenshots artifact from the CI run for raw images.
Use `gh run download <run-id> --name screenshots --dir .tmp/screenshots` to download the full set of captured screenshots from a CI run.
No. Git LFS is no longer used for screenshot storage. The external screenshot service handles image management.
Full instructions (SKILL.md)
Source of truth, from microsoft/vscode.
name: update-screenshots description: Download screenshot baselines from the latest CI run and commit them. Use when asked to update, accept, or refresh component screenshot baselines from CI, or after the screenshot-test GitHub Action reports differences. This skill should be run as a subagent.
Update Component Screenshots from CI
Screenshot baselines are no longer stored in the repository. They are managed by an external screenshot service (hediet-screenshots.azurewebsites.net). The CI workflow uploads screenshots to this service and diffs them automatically.
When the Checking Component Screenshots GitHub Action detects changes, it posts a PR comment with before/after comparisons. No manual baseline updates are needed — the screenshots on the main branch commit become the new baselines automatically after merge.
What Changed
- Baseline images were removed from
test/componentFixtures/.screenshots/baseline/. - Git LFS is no longer used for screenshot storage.
- The screenshot service stores images keyed by commit SHA and handles diffing.
If Screenshots Need Investigation
- Check the PR comment posted by the CI workflow for visual diffs.
- Download the
screenshotsartifact from the CI run for the raw captured images:
gh run download <run-id> --name screenshots --dir .tmp/screenshots
- Compare locally if needed. The artifact contains the full set of captured screenshots.
Related skills
More from microsoft/vscode and the wider catalog.

accessibility
Ensure VS Code features are accessible to all users with keyboard navigation, screen reader support, and ARIA annotations.

agent-sessions-layout
Agents workbench layout — covers the fixed layout structure, grid configuration, part visibility, editor modal, titlebar, sidebar footer, and implementation requirements. Use when implementing features or fixing issues in the Agents workbench layout.

author-contributions
Identify all files a specific author contributed to on a branch vs upstream, tracing code through renames.

azure-pipelines
Queue, monitor, and validate Azure DevOps pipeline changes for VS Code without waiting for full CI runs.

expect
Verify React/web code changes in a real browser before claiming completion.

react-doctor
Scan React code for security, performance, accessibility, and architecture issues with a 0–100 health score.