Skills

Fix Design Notes

Design notes on a PR, "Design review (advisory)" in the evidence check, "worth fixing"...

Install

npx skills add different-ai/openwork --skill fix-design-notes -g -a claude-code -y
Repository
different-ai/openwork24.4k
Category
Design
Updated
3d ago
License
See repository
Context cost
Lightabout 809 tokens
Runs scripts
No, instructions only

What it does

Design notes on a PR, "Design review (advisory)" in the evidence check, "worth fixing", layout.split-row, OW-LIST, a reviewer says the UI looks off. Use to read what the design review found on a PR's screenshots, fix it in code, and prove the note is gone.

Skill: Fix design notes

PR CI no longer runs the design review (the judge-vision job was removed). Get the notes locally: record the spec, then pnpm --dir evals design:review -- --test-run latest. Older PRs may still show notes in their Evidence preview check.

Every PR that records evidence screenshots gets an advisory design review. Its notes ride in the Evidence preview check, next to the evidence they are about: one summary line, and the notes as the check's text. They never change the evidence verdict, but a note marked Worth fixing is a defect a careful designer would send back. Fix it, or say in the PR why the screen is right.

Read the notes

sha=$(gh pr view <pr> --json headRefOid --jq .headRefOid)
check() { gh api "repos/{owner}/{repo}/commits/$sha/check-runs?check_name=Evidence%20preview" --jq ".check_runs[0].output.$1"; }
check summary   # ends with "Design review (advisory): 3 notes, 1 worth fixing." or "no notes."
check text      # the notes, then the same notes as JSON

Each note gives:

FieldUse it to
rulelayout.* was measured from the DOM (exact). S2, V2… are DESIGN.md; OW-* are the OpenWork Design rules in evals/design-review/rubric.md (judged from pixels; may vary run to run)
Screenshotthe spec step that took it, and the spec file
Where in the codegrep for the hook ([data-library-row="…"] → data-library-row) or the class list to find the component
Reproducethe command that re-records the screenshots and reviews them locally

The JSON block at the end of the check text has the same notes for scripts. The screenshots themselves are in the review report the check links to.

Reproduce, fix, verify

Read the whole SKILL.md on GitHub

More in Design