hermes

Audit design consistency across screens

Inventories spacing, type, colour, radii and component variants across screens, finds near-duplicates and plans their consolidation. Use before building or cleaning up a design system.

context

Products drift: 14 greys that should be 6, button heights of 36, 38 and 40 px, three ways to show an error, spacing that is "about 16" everywhere. Each difference is small, but together they slow every designer and engineer and make the product feel unreliable. An interface inventory makes the drift visible, separates intentional differences from accidental ones, and turns the clean-up into an ordered plan instead of a big-bang redesign.

task

Audit these screens for consistency.

screens

Only if [DESIGN_SYSTEM] is given:

design system

  1. Inventory every distinct value you can identify, per property: colours (text, backgrounds, borders), type (family, size, weight, line height), spacing (padding, gaps, margins), radii, borders, shadows, icon sizes and styles. For each value, record where it appears and how often.
  2. Cluster near-duplicates: values a user cannot tell apart or that serve the same role (#6B7280 and #6B7380, 15 px and 16 px body text, 7 px and 8 px radius). Propose one canonical value per cluster, preferring the design system's value, then the most frequent one.
  3. Check the scale: flag values off the spacing and type scale (or, without a design system, propose the scale implied by the most common values, for example a 4 px base).
  4. Component variants: list each component type (buttons, inputs, cards, alerts, tabs, modals) and every visual or behavioural variant found. Mark each variant keep, merge or remove, and name variants that exist for a real reason.
  5. Intentional versus accidental: a difference is intentional if it signals a different role or state. Do not merge those; say why they differ.
  6. Consolidation plan: order the work by impact (frequency times visibility) and risk. Start with tokens for colour and type, then spacing, then components. Group changes so each can ship on its own.
  7. If screenshots are low resolution or the description lacks values, report what can be judged visually and say what exact values are needed (for example an exported style list).
constraints
  • Report only values present in the input. Do not invent counts; when you can only estimate from images, say "approximately" and mark it.
  • Colour values read from screenshots are approximate because of compression and colour profiles. Say so and recommend confirming from source files.
  • Do not redesign. The aim is fewer, consistent values, not a new look.
  • Separate what you verified from what you inferred. Mark inferences as such.
  • When you do not know, say "I don't know" once and state what would settle it.
output format

Summary

The size of the drift in numbers (for example "11 text colours for 4 roles") and the top 3 actions.

Inventory

One table per property: | Value | Where used | Count | Cluster | Verdict (keep / merge into X / remove) |

Component variants

| Component | Variants found | Keep / merge / remove | Reason |

Consolidation plan

Numbered phases, each with scope, impact, risk and what to check after.

Mapping

| Old value | New value or token | Screens affected |

Questions

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Design
category
Design systems
level
Intermediate
made for
Product / UX / UI designer, Frontend engineer
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install audit-design-consistency --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill audit-design-consistency -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the design plugin
claude plugin install hodios-design@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Design systems
PromptDesign systems

Define a design token architecture

Designs a three-tier design token architecture (primitive, semantic, component) with naming conventions, theming rules and a sample token file. Use when starting or restructuring a design system.

define-design-tokens
PromptDesign systems

Write a design-system component spec

Writes a design-system component spec covering anatomy, variants, states, behaviour, tokens, content rules, dos and don'ts, and accessibility. Use when adding or documenting a component.

write-component-spec
PromptUI design

Critique a UI screen

Critiques one interface screen for hierarchy, layout, consistency, clarity and accessibility against its goal, and returns prioritised, concrete fixes. Use when reviewing a mockup or live screen.

critique-ui-screen
PersonaUI design

Product designer

Product designer who frames the problem before the pixels, explores several options, designs every state and defends decisions with user evidence. Use as a design partner or reviewer.

product-designer
PromptDesign systems

Define an icon system

Defines an icon system with grid and keylines, stroke and corner rules, sizes, naming, metaphors, accessibility and contribution rules. Use when a design system creates or tidies up its icons.

define-iconography
PromptDesign systems

Design a dark theme

Designs a dark theme from an existing light palette, covering surface elevation, semantic colour mapping, contrast checks, images, charts and token changes. Use when a design system adds dark mode.

design-dark-mode