🔍
QualityPython

Screenshot Validation

by liaohch3

Screenshot Validation is a Quality skill for Claude Code, published by liaohch3 in claude-tap.

3.1K stars266 forkson liaohch3/claude-tapAdded 2026/08/17+1% in starsRepository updated 2026/08/16
agent-debuggingagent-observabilityai-agentsai-toolsapi-debuggingclaude-codecodexcodex-clicursor-clideveloper-toolsgemini-clihermes-agentkimillmllm-proxyopencodepi-coding-agentproxytracetrace-viewer
Install in seconds
Install Screenshot Validation
Copy Screenshot Validation into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/liaohch3/claude-tap/tree/main/.agents/skills/screenshot-validation ~/.claude/skills/screenshot-validation

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/liaohch3/claude-tap.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
.agents/skills/screenshot-validation/SKILL.md in liaohch3/claude-tap
Installs to
~/.claude/skills/screenshot-validation
Collection
One of 11 skills cataloged from this repository
Category
Quality1354 skills

What Screenshot Validation does

Screenshot Validation checks evidence images and viewer HTML files for quality standards before committing, catching issues like small or blank screenshots and viewer rendering errors. Use it after generating PR evidence or new trace viewer HTML.

Screenshot Validation is cataloged under Quality on DirSkills. Screenshot Validation comes from a repository tagged agent-debugging, agent-observability, ai-agents, ai-tools and api-debugging.

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.

Frequently asked about Screenshot Validation

  • What else does liaohch3 publish alongside Screenshot Validation?

    Screenshot Validation is one of 11 skills that DirSkills catalogs from liaohch3/claude-tap, the repository it ships in. Its siblings there include Claude Tap E2E Test, Codex E2E Test and Demo Video Generation. Each one is a separate skill with its own page in this directory, installs the same way Screenshot Validation does, and is maintained by liaohch3 in that same repository. The rest of the collection is listed on the liaohch3/claude-tap page.

  • How does Screenshot Validation compare to other Quality skills?

    Screenshot Validation ranks #432 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Screenshot Validation against them. Open each page to compare what they document and how they install.

More from liaohch3/claude-tap

Screenshot Validation is one of 11 skills cataloged on DirSkills from liaohch3/claude-tap.

See all 11 skills
🧪
2w ago

Claude Tap E2E Test

Claude Tap E2E Test runs the claude-tap end-to-end test suite with pytest to validate core proxy logic, trace writing, viewer streaming, signal handling, and startup behavior after modifying core code.
Quality
3.1K266
🧪
2w ago

Codex E2E Test

Codex E2E Test runs PR-grade real Codex E2E validation through claude-tap, including resume turns, multiple tool calls, optional image input, viewer verification, and screenshot evidence. Use it for every PR that changes capture, proxying, viewer rendering, or trace behavior.
Quality
3.1K266
🎥
2w ago

Demo Video Generation

Demo Video Generation records terminal sessions in tmux with asciinema and converts them to GIF and MP4 demo assets, then captures viewer screenshots via Playwright for documentation. Use it to create realistic demos from real E2E runs and UI views.
Automation
3.1K266
🧪
2w ago

JS in HTML Testing

JS in HTML Testing verifies JavaScript embedded in HTML files using a two-layer strategy: Python unit tests for pure logic and Playwright browser tests for DOM interaction. Use it to test embedded scripts without full end-to-end runs.
Quality
3.1K266
📋
2w ago

Legibility Check

Legibility Check runs deterministic checks on maintainer docs to catch stale standards metadata, broken architecture manifest paths, and plan state drift before CI does. Use it after modifying files under .agents/docs/standards/, .agents/docs/plans/, .agents/docs/architecture/, or AGENTS.md.
Quality
3.1K266
2w ago

PR Preflight

PR Preflight runs a full merge-readiness check before opening or merging a pull request, validating local gates (lint, format, tests), CI status, screenshot evidence, and PR metadata in one pass.
Quality
3.1K266