Agent skill

Design QA

by damianvtran in damianvtran/local-operator

Deterministic design review for UI/UX on web and terminal screens: measure contrast, spacing, overlap, clipping and copy defects, then judge the rest.

MITAuto-check passedFrontend & Design

Install Design QA

skills CLI
$ npx skills add damianvtran/local-operator --skill design-qa -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install damianvtran/local-operator design-qa --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/damianvtran/local-operator.git skills-src && mkdir -p .claude/skills && cp -r skills-src/local_operator/skills/builtin/design-qa .claude/skills/design-qa && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
design-qa
GitHub stars
217
Token cost
~729 tokens
SKILL.md length
397 words
Files
4 (incl. references)
Repo updated
First seen
Licence
MIT

At a glance

Deterministic design review for UI/UX on web and terminal screens: measure contrast, spacing, overlap, clipping and copy defects, then judge the rest.

  • Works in 5 steps: Get rendered frames, never source alone.… → Run the deterministic checks for the… → Capture a frame per matrix cell. Where… → …
  • Reviewing a screen
  • SKILL.md covers Lane 1: measure, Lane 2: judge, Matrix: states x viewports and Procedure, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Design QA is an agent skill from damianvtran/local-operator. Deterministic design review for UI/UX on web and terminal screens: measure contrast, spacing, overlap, clipping and copy defects, then judge the rest. Use when reviewing a screen, dashboard, or interface's visual design.

Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/checks-copy.md`, `references/checks-tui.md` and `references/checks-web.md`).

It sits in Frontend & Design, covering UI design and Design review and critique. The repository describes itself as: An open-source AI agent hub for your own machine: build organizations of collaborating agents that message each other, run in the background around the clock, and share your… The licence is MIT.

When your agent uses it

  • Reviewing a screen
  • Interfaces visual design

Example prompts

  • “/design-qa”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Get rendered frames, never source alone. Web: drive the harness browser tool (background tab, logins intact; never install or script a…
  2. Run the deterministic checks for the surface; keep each check's real output.
  3. Capture a frame per matrix cell. Where anything animates, compare consecutive frames: a first frame that differs from the settled frame is…
  4. Form judgements against the brief and the states, not against taste.
  5. Report findings with severity and evidence. Where the round format uses D-prefixed ids (D1, D2, ...), keep them stable across rounds and…

What it can do on your machine

Read from SKILL.md and the folder at commit 05e4c97. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Design QA loads about 729 tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 397 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~729
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from damianvtran/local-operator at commit 05e4c97, republished under its MIT licence (© damianvtran). 397 words, ~729 tokens.

Download SKILL.mdSave it as .claude/skills/design-qa/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
design-qa
description
Deterministic design review for UI/UX on web and terminal screens: measure contrast, spacing, overlap, clipping and copy defects, then judge the rest. Use when reviewing a screen, dashboard, or interface's visual design.

Design QA

A quality gate for user-visible interfaces, web or terminal. Two lanes, in order: measure, then judge. Every claim carries evidence.

Lane 1: measure

Run the deterministic checks for the surface before forming any opinion, and cite each number's actual source (computed style, bounding box, log line). Never report an unmeasured number; if you cannot measure it, say so.

  • Web: references/checks-web.md
  • Terminal: references/checks-tui.md
  • Copy: references/checks-copy.md

Lane 2: judge

Judge only what measurement cannot decide: hierarchy (does the eye land in the right place), flow (is the next step obvious), does the screen answer its own question, do the states tell the truth. Judgement stands on the lane 1 numbers. Where you must eyeball, say that you did.

Matrix: states x viewports

Cover every state the surface has, at narrow, standard, and wide. Themes and personalization axes the product supports (dark mode, display sizes) are extra columns.

narrowstandardwide
loading
empty
error
populated

For terminal UIs, "viewports" are terminal sizes; include the smallest width the product promises. A single happy-path screenshot is not coverage.

Procedure

  1. Get rendered frames, never source alone. Web: drive the harness browser tool (background tab, logins intact; never install or script a browser engine). Terminal: drive the real app that loads the shipped styles, not a bare test host, and export with the app's own capture facility.
  2. Run the deterministic checks for the surface; keep each check's real output.
  3. Capture a frame per matrix cell. Where anything animates, compare consecutive frames: a first frame that differs from the settled frame is motion the user sees.
  4. Form judgements against the brief and the states, not against taste.
  5. Report findings with severity and evidence. Where the round format uses D-prefixed ids (D1, D2, ...), keep them stable across rounds and verify fixes only on changed surfaces.
Show full SKILL.md (94 more words)Show less

Honest degrade

When a check cannot run (no browser tool, no render path), report: static-inspected only, unverified: <the checks that could not run>. Never let could-not-check read as a pass.

Red flags

  • Installing or scripting a browser engine to get a frame; use the harness browser tool or say frames are unavailable.
  • A finding with an eyeballed number ("about 12px apart").
  • One viewport, one state, or one theme presented as coverage.
  • Skipping lane 1 and judging from taste, or skipping lane 2 and reporting only metrics.
  • Reviewing source and calling it a design review.

© damianvtran, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in local_operator/skills/builtin/design-qa of damianvtran/local-operator.

  • SKILL.md
  • references/checks-copy.md
  • references/checks-tui.md
  • references/checks-web.md

Open the folder on GitHubat commit 05e4c97

Compare with similar skills

Design QA next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Design QA compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Design QA this skilldamianvtran/local-operator217—~729Automated safety check: PassMIT
Interface Design for Dashboards and Appsholaboss-ai/holaOS11k3 repos~6kAutomated safety check: PassMIT
Tastemaker UI Designcodeswithroh/tastemaker444—~16kAutomated safety check: PassMIT
UI Aesthetics Judgmentkasonye/ui-aesthetics-skill383—~3.2kAutomated safety check: PassNone
Agentos UI UXSapienXai/AgentOS118—~4.4kAutomated safety check: PassMIT
Distinctive UI Buildertw93/Waza7.2k—~3.7kAutomated safety check: PassMIT

Similar skills

  • Pushes an agent past generic defaults when designing dashboards, admin panels, SaaS apps and tools, with attention to structure, type, navigation and how data is shown.

    11k GitHub starsUsed in 3 repos~6k tokens
    Frontend & DesignAuto-check passed
  • Tastemaker UI Design

    codeswithroh/tastemaker

    Grounds AI-built interfaces in real reference images and a saved personal taste profile, so UI work avoids the generic defaults of typical generated apps.

    444 GitHub stars~16k tokensUpdated 12 days ago
    Frontend & DesignAuto-check passed
  • UI Aesthetics Judgment

    kasonye/ui-aesthetics-skill

    Sets rules for web UI work that favor hierarchy, spacing and restrained styling, with routes for generating, reviewing and polishing interfaces.

    383 GitHub stars~3.2k tokensUpdated 6 mo ago
    Frontend & DesignAuto-check passed
  • Agentos UI UX

    SapienXai/AgentOS

    Design, review, or implement AgentOS UI and UX work using the project’s operator-console visual system.

    118 GitHub stars~4.4k tokensUpdated 7 days ago
    Frontend & DesignAuto-check passed
  • Builds or restyles production UI with a clear point of view, checks the result against screenshots and responsive states, and hands document typography to other skills.

    7.2k GitHub stars~3.7k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Fix PR Design Notes

    different-ai/openwork

    Reads the advisory design review attached to a pull request's screenshots, fixes the flagged UI problems in product code, and proves each note is gone.

    24k GitHub stars~824 tokensUpdated today
    Frontend & DesignAuto-check passed

More from damianvtran/local-operator

All 8 skills in this repo
  • Skill Authoring

    damianvtran/local-operator

    Writing and improving agent skills: description as routing signal, progressive disclosure, token budgets, testing before shipping, and improving from repeated mistakes.

    217 GitHub stars~748 tokensUpdated today
    Auto-check passed
  • Code Review

    damianvtran/local-operator

    Reviewing code for defects: diff-first reading, severity classification, evidence over inference, finding caps, and terminal verdicts.

    217 GitHub stars~672 tokensUpdated today
    Auto-check passed
  • Data Analysis

    damianvtran/local-operator

    Analysing data rigorously: profile before trust (keys, missingness), reproducible queries, provenance per number, units and sanity checks.

    217 GitHub stars~709 tokensUpdated today
    Auto-check passed
  • Financial Analysis

    damianvtran/local-operator

    Financial figures done carefully: periods and fiscal calendars, units and currencies, reconciliation, magnitude sanity checks, sourced assumptions.

    217 GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Frontend Design

    damianvtran/local-operator

    Designing interfaces with a deliberate point of view: plan before pixels, avoid the generic-default look, typography and colour discipline, a quality floor that is not negotiable.

    217 GitHub stars~773 tokensUpdated today
    Auto-check passed
  • Responding To Review

    damianvtran/local-operator

    Answering review findings: verify each claim before implementing, no performative agreement, per-item fix/reject/defer with evidence, one batched remediation round.

    217 GitHub stars~616 tokensUpdated today
    Auto-check passed

Questions about Design QA

What does Design QA do?

Deterministic design review for UI/UX on web and terminal screens: measure contrast, spacing, overlap, clipping and copy defects, then judge the rest. Design QA is an agent skill from damianvtran/local-operator. Deterministic design review for UI/UX on web and terminal screens: measure contrast, spacing, overlap, clipping and copy defects, then judge the rest.

When should I use Design QA?

Design QA fits situations like: reviewing a screen; interfaces visual design.

How do I install Design QA in Claude Code?

Run `npx skills add damianvtran/local-operator --skill design-qa -a claude-code`. Or copy the skill folder (local_operator/skills/builtin/design-qa in damianvtran/local-operator) into .claude/skills/design-qa in your project. Claude Code loads it when a task matches its description.

How do I install Design QA in Codex?

Run `npx skills add damianvtran/local-operator --skill design-qa -a codex`. Or copy the skill folder (local_operator/skills/builtin/design-qa in damianvtran/local-operator) into .agents/skills/design-qa in your project. Codex loads it when a task matches its description.

Can I use Design QA in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add damianvtran/local-operator --skill design-qa -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design-qa, .gemini/skills/design-qa, .github/skills/design-qa and .opencode/skills/design-qa in your project.

What does Design QA need to run?

SKILL.md names no scripts, command-line tools or credentials: Design QA is instructions for the agent only.

Does Design QA access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Design QA safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Design QA use?

Design QA is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Design QA use?

About 729 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Design QA?

Skills that share tags, products or a category with Design QA: Interface Design for Dashboards and Apps (holaboss-ai/holaOS, 11k stars), Tastemaker UI Design (codeswithroh/tastemaker, 444 stars), UI Aesthetics Judgment (kasonye/ui-aesthetics-skill, 383 stars) and Agentos UI UX (SapienXai/AgentOS, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Design QA?

damianvtran (a GitHub user) maintains it in damianvtran/local-operator, which has 217 GitHub stars. The repository was last updated on October 11, 2026.

Source: damianvtran/local-operator on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.