Test Manager

Run visual regression tests comparing screenshots to golden files.

1|1|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/sunholo-data/stapledons_voyage --skill test-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Test Manager
Source: https://github.com/sunholo-data/stapledons_voyage/tree/main/.claude/skills/test-manager
Command: npx skills add https://github.com/sunholo-data/stapledons_voyage --skill test-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires go, and includes scripts (resource) components.

What problem does it solve?

This Skill enables automated visual regression testing for Stapledon's Voyage by running test scenarios, capturing screenshots, and comparing them to committed golden files to detect UI changes and regressions.

Core Features & Use Cases

  • Test Execution: Run test scenarios in UI-stripped (test) mode to generate current outputs.
  • Golden Comparison: Compare current outputs against golden files to detect differences.
  • Bug Reporting: Generate structured bug reports for visual regressions.

Quick Start

  • Run all scenarios: .claude/skills/test-manager/scripts/run_tests.sh
  • Compare golden files: .claude/skills/test-manager/scripts/compare_golden.sh
  • Report a bug: .claude/skills/test-manager/scripts/report_bug.sh <scenario> "<description>"

Frequently Asked Questions about Test Manager

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

FAQPage Schema
How do I automate visual regression testing to catch UI changes?

Visual regression testing automatically compares current screenshots against golden-file references to detect UI inconsistencies. This Skill runs test scenarios in UI-stripped mode, captures 1280x960 renders with deterministic seeds, and generates diffs to identify visual regressions before they reach production.

What's the difference between golden files and current test outputs?

Golden files are committed reference screenshots representing the expected UI state. Current outputs are fresh renders from test scenarios. Comparing them reveals whether recent code changes altered the UI visually—changes flagged as regressions or intentional updates.

How do I run visual regression tests and report bugs?

Execute run_tests.sh to generate current outputs, compare_golden.sh to detect differences against golden files, and report_bug.sh to create structured bug reports. The Skill generates diffs via ImageMagick when available, making regressions visible and traceable.

Can I use visual regression testing in CI pipelines?

Yes. This Skill integrates into CI workflows by automating test execution, golden-file comparison, and diff generation. Run tests on every commit to catch visual regressions early, ensuring UI consistency across builds without manual screenshot review.

Do I need ImageMagick to compare visual changes?

ImageMagick is optional but enables diff generation for visual comparison. Without it, the Skill still detects differences between current and golden files; diffs simply won't render as images. Install ImageMagick for visual diff output in reports.

When should I update golden files versus report them as bugs?

Update golden files when UI changes are intentional—new designs approved and ready to commit. Report visual regressions as bugs when changes are unintended or break existing functionality. Use update_golden.sh for approved changes and report_bug.sh for unexpected deviations.