ui-judge

Capture URL screenshots at multiple viewports and score UI quality against a five-criterion rubric.

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/charleshall888/cortex-command --skill ui-judge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-judge
Source: https://github.com/charleshall888/cortex-command/tree/main/plugins/cortex-ui-extras/skills/ui-judge
Command: npx skills add https://github.com/charleshall888/cortex-command --skill ui-judge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manual UI quality assessment and visual regression checks are time-consuming and prone to human error. ui-judge automates this process by capturing screenshots from a live URL, evaluating them against a five-criterion rubric, and producing a structured verdict.

Core Features & Use Cases

  • Capture screenshots of a URL at multiple viewport sizes and score against a five-criterion visual quality rubric.
  • Run a two-call LLM process per viewport to generate a JSON verdict and identify affected selectors for targeted fixes.
  • Persist results to ui-check-results/judge.json for single-viewport runs or per-viewport judge-<viewport>.json files for multi-viewport scenarios.

Quick Start

Trigger the skill in Claude Code with /ui-judge to generate a visual quality verdict for the current UI.

Frequently Asked Questions about ui-judge

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

FAQPage Schema
How do I automate UI visual quality evaluation using screenshots?

Automate UI visual evaluation by capturing URL screenshots at multiple viewports and scoring them against a five-criterion rubric. A two-step LLM process generates a structured JSON verdict and identifies impacted selectors for targeted fixes.

What is visual regression checking and how does an automated rubric work?

Visual regression checking compares UI screenshots against expected quality standards. This skill uses a five-criterion rubric evaluated through a two-call LLM process per screenshot to produce a structured verdict detailing visual quality and affected selectors.

How do I capture screenshots at different viewport sizes for UI testing?

Capture screenshots at different viewport sizes for UI testing by triggering an automated evaluation that runs per viewport. Multi-viewport runs generate separate judge-<viewport>.json files, while single-viewport runs write results to judge.json.

Does UI evaluation with Claude vision identify specific CSS selectors to fix?

Yes, UI evaluation with Claude vision identifies specific CSS selectors to fix. The two-step LLM process generates a structured JSON verdict and then isolates impacted selectors for targeted UI corrections.

Can I use Playwright screenshots for LLM-based visual quality scoring?

Yes, you can use Playwright screenshots for LLM-based visual quality scoring. The skill captures URL screenshots and applies a two-call LLM process to evaluate them against a five-criterion visual quality rubric, outputting a JSON verdict.

What are the limitations of automated UI evaluation and will it fail my build?

Automated UI evaluation is advisory only and will not fail your build, as the workflow always exits with code 0. It provides a structured verdict to guide manual fixes rather than enforcing strict pass/fail gates.