experience-judge

Scores visual quality of captured website screenshots and records verdicts in a YAML judgment register.

Updated May 31, 2026
One-click install
npx skills add https://github.com/4444J99/limen --skill experience-judge-4444j99
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: experience-judge
Source: https://github.com/4444J99/limen/tree/main/.agents/skills/experience-judge
Command: npx skills add https://github.com/4444J99/limen --skill experience-judge-4444j99

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright.

What problem does it solve? Automated audits can verify that a page loads fast and without errors, but they cannot tell whether the page actually looks good. This Skill closes that gap by having a model or human reviewer score the visual quality of captured public-site screenshots and record structured verdicts that downstream tooling can turn into fix tasks. ## Core Features & Use Cases - Visual scoring rubric: Rates each captured surface 0-5 on layout, typography, coherence, and trust, with a pass/fail verdict and concrete defects plus a suggested fix. - Artifact-pinned judgments: Every verdict is bound to the screenshot's sha256 and capture timestamp, so stale or mismatched captures are detected and re-swept before judging. - Register integration: Appends schema-validated rows to experience-judgments.yaml and opens a PR, enabling the effector to file bounded visual-fix tasks for failed surfaces. - Use Case: After a nightly experience-audit sweep captures screenshots of all public pages, run this Skill to review each shot, flag a landing page with broken typography as fail, and let the backlog generator create a fix task automatically. ## Quick Start Judge the visual quality of the surfaces in the latest experience-audit sweep and record the verdicts.

Frequently Asked Questions about experience-judge

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

FAQPage Schema
How do I judge the visual quality of my website pages automatically?▼

Run the experience-audit sweep with playwright to capture screenshots, then review each shot and score it 0-5 on layout, typography, coherence, and trust. Append the verdicts to the experience-judgments.yaml register so the effector can file fix tasks for failures.

What is the difference between experience-audit.py and visual judging?▼

experience-audit.py measures mechanical rungs like reachability, speed, page weight, broken images, and console errors. Visual judging is the complementary step that evaluates whether the page actually looks credible and well-designed, which mechanical checks cannot determine.

Why does the judgment require a matching screenshot sha256?▼

The sha256 pins each verdict to the exact pixels that were judged. If a newer sweep changed the capture, the old verdict no longer applies, so a mismatch means you must re-sweep before scoring to avoid judging stale screenshots.

Can I judge visuals without playwright screenshots?▼

No. The HTTP tier of the audit captures no screenshots, so a real visual judgment requires the playwright tier with chromium installed. Without shots there is nothing to score on layout or typography.

What happens after a surface gets a fail verdict?▼

Once the judgment PR merges, the effector script generate-experience-backlog.py reads the register and files bounded EXP-<surface>-visual tasks for any surface marked fail, including the recorded defects and suggested fix.