ui-visual-review SKILL.md skillA

ui-visual-review from uzysjung/uzys-agent-harness is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add uzysjung/uzys-agent-harness/ui-visual-review@git:20260927.7ff1996

Pins git:20260927.7ff1996 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
uzysjung/uzys-agent-harness
Path
templates/skills/ui-visual-review/SKILL.md
Versions recorded
5
Latest version
git:20260927.7ff1996, committed Sep 27, 2026
First version recorded
Jun 26, 2026
Size
10,080 bytes
Repository stars
3
License
MIT

Captures and compares key UI-flow screenshots after E2E tests pass on UI tracks (csr-*, ssr-*, full), flags visual regressions and console errors, and prepares findings for user approval. Also owns browser-launch rules: read before opening any browser via Playwright, chrome-devtools MCP, or a launcher. Use for manual E2E checks, reference-product UX/fidelity comparisons, OAuth login, automated capture, or reported browser lag.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# UI Visual Review

## Purpose

E2E 테스트가 PASS 했어도 시각적 회귀(layout shift, 색상/간격 변화, 빈 화면, 잘림)는 functional test가 못 잡는다. 본 skill은:

1. 핵심 사용자 화면을 자동 캡처
2. 이전 baseline과 diff
3. 에이전트가 명백한 regression 1차 판정
4. 사용자가 최종 승인 → 새 baseline 채택 또는 수정 요청

수동으로 스크린샷을 모아 눈으로 비교하던 패턴을 자동화 + diff + 에이전트 사전 판정으로 옮긴 형태.

## When to Invoke

| 트리거 | 행동 |
|--------|------|
| E2E 테스트 PASS + UI Track(csr-*/ssr-*/full) | 본 skill 호출 권유 |
| UI 변경 PR review | visual diff 결과 review 입력으로 |
| 의도적 디자인 변경 후 baseline 갱신 | "approve all" 옵션 |
| Track이 data/tooling/executive | **skip** — UI 없음 |

## Pre-conditions

- Playwright 또는 chrome-devtools MCP 사용 가능 (UI Track 설치 시 기본 포함)
- 앱이 로컬에서 기동 가능 (예: `pnpm dev`, `docker-compose up`)
- 핵심 화면 URL 리스트가 정의됨 (없으면 본 skill 첫 실행 시 사용자 질의)

## 브라우저를 띄우는 법 (영속 profile)

브라우저를 띄워 **사람이 직접 쓰는** 모든 상황(E2E 수동 확인, UX 비교, fidelity audit, OAuth
로그인)에 적용한다. **브라우저를 여는 어떤 방법이든 그 전에** 이 절을 읽는다 — 아래 금지는 어기고
나서 되돌리는 비용이 크다(재로그인·세션 소실·사용자 입력 지연).

### 절대 금지

- **사용자 활성 Chrome 에 attach** (`mcp__chrome-devtools__*`) — 사용자 입력이 느려진다.
- **일회성 browser context** (Playwright MCP, `browser.newContext()`) — 영속 profile dir 이 없어
  cookie · IndexedDB · Service Worker 가 휘발한다. 매 launch 재로그인 + 버벅임.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add uzysjung/uzys-agent-harness/ui-visual-review@sha256:8d5c23460b4ba78c

The line at the top of this page pins the label git:20260927.7ff1996, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_x2p566wgggsyozmo.svg)](https://markdownregistry.com/a/art_x2p566wgggsyozmo)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jun 26, 2026 and Sep 27, 2026, about one every 23 days.

versioncommittedcommitsizeaudit
git:20260927.7ff1996 latest2026-09-27 7ff1996 10,080 BA view · diff
git:20260812.35dfb0b2026-08-12 35dfb0b 10,415 BA view · diff
git:20260726.eb902412026-07-26 eb90241 9,315 BA view · diff
git:20260719.a77fd362026-07-19 a77fd36 5,895 BA view · diff
git:20260626.033aff12026-06-26 033aff1 6,016 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10080 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

uzysjung/uzys-agent-harness · 3 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_x2p566wgggsyozmo
GET https://markdownregistry.com/api/v1/resolve?ref=uzysjung/uzys-agent-harness/ui-visual-review
GET https://markdownregistry.com/api/v1/blob/8d5c23460b4ba78c9b8077d9e6de59af5a38ea3035ca65f5cf645140ba523741

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from uzysjung/uzys-agent-harness

CLAUDE.md@.claude CLAUDE.md file
uzysjung/uzys-agent-harness · .claude/CLAUDE.md
git:20260920.4f13f6d · audit A · 3 stars
audit-harness-fit SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/audit-harness-fit/SKILL.md · Improve agent instructions and skills for autonomous, productive delivery with verifiable quality. Resolve needless…
git:20261012.88096fe · audit A · 3 stars
audit-service-gaps SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/audit-service-gaps/SKILL.md · Audits the observable gaps between a service as it is today and an explicit target state, then researches how reference…
git:20260913.d34c425 · audit A · 3 stars
compaction-handoff SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/compaction-handoff/SKILL.md · Create a compact, reconstructible checkpoint immediately before context compaction. Persist only durable facts and…
git:20260913.a125453 · audit A · 3 stars
external-model-consult SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/external-model-consult/SKILL.md · Uses bundled CLI wrappers for Gemini Korean copywriting/polishing and different-model critiques of designs, plans, or…
git:20261011.510aa0b · audit B · 3 stars
gh-issue-workflow SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/gh-issue-workflow/SKILL.md · Runs work through GitHub Issues so the user and the agent can see the same backlog: normalize an incoming request into…
git:20260817.f6f0c9c · audit A · 3 stars
model-orchestration SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/model-orchestration/SKILL.md · Select models, reasoning effort, and delegation boundaries for a task. Use when choosing direct execution versus…
git:20261011.510aa0b · audit A · 3 stars
multi-persona-review SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/multi-persona-review/SKILL.md · A panel-review skill that critiques ONE artifact (launch post, README, doc, markdown, plan, design) via 3-5 disjoint…
git:20260809.41b1eda · audit A · 3 stars
north-star SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/north-star/SKILL.md · Defines and enforces a project's long-term direction (North Star Statement, metric-as-proxy NSM, strategic Pillars with…
git:20260830.f31c1d9 · audit A · 3 stars
objective-brief SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/objective-brief/SKILL.md · Rewrite work about to be delegated, designed, or run over several steps into the canonical XML brief — objective…
git:20261014.0ec0829 · audit A · 3 stars
recurrence-prevention SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/recurrence-prevention/SKILL.md · When the same defect, mistake, or incident happens AGAIN — a recurrence, not a one-off — verify it against prior…
git:20260920.d109313 · audit A · 3 stars
user-centered-explanation SKILL.md skill
uzysjung/uzys-agent-harness · .claude/skills/user-centered-explanation/SKILL.md · 개발 중 문제·변경안·선택지를 사용자 행동과 결과의 관점에서, 사용자의 언어로 설명한다. 맥락·원인·대안·추천 이유를 연결하고, UI/UX 변경은 필요한 화면·문구·동작의 전후 차이를 보여준다. 사용자가 "뭔…
git:20260920.4f13f6d · audit A · 3 stars

Every file in uzysjung/uzys-agent-harness

Browse by kind, by grade A, or by owner.