Skip to content
Codex DesignBETA

Design QA skill for Codex.

The Design QA skill has Codex compare a prototype with its source design, side by side, and turn the differences into a prioritized fix list. It ships in OpenAI’s Product Design plugin, where it gates every build before handoff.

Updated November 12, 2026 · 3 min read

At a glance

Skill namedesign-qa
Comes withThe Product Design plugin, by OpenAI
Installcodex plugin add product-design@openai-curated, or /plugins in Codex
Codex uses itNot on its own: the plugin’s build skills call it, or you name it. It’s not for general UX critiques
Sourceopenai/plugins on GitHub

What it does

The skill needs two things: a source design (a Figma node, image, screenshot or mockup) and a rendered build (a local or deployed URL, app screen or screenshot). It opens both, matches viewport, state and theme, and puts them in the same comparison input instead of judging them one at a time.

Every report must cover five surfaces:

  • Fonts and typography: family, weight, size, line height, spacing and wrapping.
  • Spacing and layout: margins, padding, grid, gaps, radii and shadows.
  • Colors and tokens: palette, contrast, state colors and how CSS tokens map to the design.
  • Images and assets: crop, sharpness and art direction. It fails QA if real images or logos were swapped for CSS shapes, hand-drawn SVGs or emoji.
  • Copy: the app-specific text.

Findings are graded P0 to P3, each with location, evidence, impact and a concrete fix. It’s a loop: any P0, P1 or P2 keeps the result blocked until Codex fixes it and compares again. The report is saved as design-qa.md, ending in exactly final result: passed or final result: blocked.

When to use it

It runs automatically after the Image to Code and URL to Code skills. Call it yourself when you have a design and a build and want an honest list of where they differ. For a review of a whole flow, use the Audit skill instead.

Try it

Check a build against its mockup
Use the design-qa skill. Compare the running app at localhost:5173 with mockup.png at the same desktop viewport. List the differences by severity, fix the P0 to P2 issues, and save design-qa.md.

Does it work in Claude Code?

Mostly. The comparison method, severity scale and report format are plain instructions, and the rubric file comes with the folder, so you can copy it into ~/.claude/skills. What won’t carry over: its capture step points to the Product Design plugin’s Browser Choice rule (the Codex in-app browser), and Figma sources need the Figma MCP server. Give Claude Code its own way to screenshot the build.

Keep reading

An independent plugin for Codex. Not affiliated with or endorsed by OpenAI.