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.
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.
Audit these screens for consistency.
Only if [DESIGN_SYSTEM] is given:
- 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.
- Cluster near-duplicates: values a user cannot tell apart or that serve the same role (
#6B7280and#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. - 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).
- 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.
- Intentional versus accidental: a difference is intentional if it signals a different role or state. Do not merge those; say why they differ.
- 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.
- 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).
- 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.
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
use in
npx @hermes-hq/hodios install audit-design-consistency --target claude-codenpx skills add hermes-hq/hodios-dist --skill audit-design-consistency -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-design@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Design systemsDefine 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-tokensWrite 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-specCritique 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-screenProduct 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-designerDefine 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-iconographyDesign 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