Documentation
README
Screenshot Validation
Validate that evidence images and viewer HTML files meet quality standards before committing. This catches issues that would otherwise fail CI or produce misleading PR evidence.
Image quality check
Checks PNG/JPG/GIF/WEBP files for:
- Minimum dimensions: 400x400 pixels (hard fail)
- Desktop viewport width: >= 1280px (warning if narrower)
- File size: <= 5MB (warning if larger)
- Blankness detection (PNG only): fails if > 90% of pixels are white/transparent
Run on specific files or directories
uv run python scripts/check_screenshots.py .agents/evidence/pr/
uv run python scripts/check_screenshots.py .agents/recordings/
uv run python scripts/check_screenshots.py path/to/specific-image.png
Run on git-staged images
This is the opening of the README. Read the full README on GitHub.