Apply the principle of Consistency — making similar things look and behave similarly so users can transfer learning across the interface.

Apache-2.0Auto-check passedFrontend & Design

Install Consistency

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill consistency -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins consistency --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/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/consistency .claude/skills/consistency && 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
consistency
GitHub stars
1.2k
Token cost
~3.2k tokens
SKILL.md length
1,789 words
Files
2 (incl. references)
Skills in repo
686
Repo updated
First seen
Licence
Apache-2.0

At a glance

Apply the principle of Consistency — making similar things look and behave similarly so users can transfer learning across the interface.

  • Designing component libraries
  • SKILL.md covers Why this matters, When to break consistency, Diagnosing consistency problems and Sub-skills in this cluster, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Defining naming conventions

What it does

Consistency is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the principle of Consistency — making similar things look and behave similarly so users can transfer learning across the interface. Use when designing component libraries, defining naming conventions, choosing whether to invent or borrow patterns, auditing across surfaces (web, mobile, email, support docs), or evaluating whether two features should share or diverge in their interaction model. Strong consistency reduces cognitive load and learnability cost; aggressive consistency can flatten meaningful…

Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/lineage.md`).

It sits in Frontend & Design, covering Design systems and Help center and FAQ content. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • Designing component libraries
  • Defining naming conventions
  • Choosing whether to invent
  • Borrow patterns

Example prompts

  • “/consistency”

What it can do on your machine

Read from SKILL.md and the folder at commit 78497e5. 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

Consistency loads about 3.2k tokens when it runs, and up to ~5.3k if it reads all its reference files. Until then it costs about 160 tokens; SKILL.md has 1,789 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~160
When it runs · the whole SKILL.md, loaded when a task matches
~3.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.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 hashgraph-online/awesome-codex-plugins at commit 78497e5, republished under its Apache-2.0 licence (© hashgraph-online). 1,789 words, ~3,209 tokens.

Download SKILL.mdSave it as .claude/skills/consistency/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
consistency
description
Apply the principle of Consistency — making similar things look and behave similarly so users can transfer learning across the interface. Use when designing component libraries, defining naming conventions, choosing whether to invent or borrow patterns, auditing across surfaces (web, mobile, email, support docs), or evaluating whether two features should share or diverge in their interaction model. Strong consistency reduces cognitive load and learnability cost; aggressive consistency can flatten meaningful differences. There are four kinds — aesthetic, functional, internal, external — each with different applications.

Consistency

Definition. Consistency is the principle that similar things should look and behave similarly, and that different things should look and behave differently. When two parts of a system serve the same function, they should be expressed the same way, so the user's learning about one transfers immediately to the other. When two parts serve different functions, they should be visually and behaviorally distinct, so the user is not misled into expecting the same behavior.

The principle sounds simple and is, in practice, one of the hardest to apply well. The hard part is judging what counts as similar. Two buttons that share a visual style but trigger different kinds of actions are misleadingly consistent — they tell the user "we work the same way" when they don't. Two equivalents in the system that are styled differently for no good reason are inconsistent — they force the user to learn the same lesson twice. The skill is calibration: enough consistency to support transfer, enough variation to honor genuine differences.

The classic taxonomy, due to Lidwell, Holden, and Butler, distinguishes four kinds of consistency.

Aesthetic consistency. Visual style, typography, color, spacing, iconography. The interface looks like it belongs to one product, drawn from one design system. Aesthetic consistency builds brand recognition and signals craft. Its absence — components that obviously came from different libraries, typography that varies arbitrarily — signals that the team didn't coordinate.

Functional consistency. Equivalent operations work the same way. The "save" gesture saves in every screen; the "delete" affordance deletes in every list; the "back" gesture goes back everywhere. Functional consistency lets users learn an interaction once and apply it throughout the product. Its absence creates "exception fatigue" — the user can't predict what any control will do without reading.

Internal consistency. Within the product, similar things are similar. This combines aesthetic and functional consistency at the level of "we have one design system and we apply it." Internal consistency is what users notice as "this product feels coherent."

External consistency. Across products and platforms, similar things follow shared conventions. The hamburger menu means menu in your app because it means menu in every app. The pinch gesture zooms because it zooms everywhere. External consistency is the user's transferred learning across products being honored. Its absence — your product reinventing standard patterns — creates avoidable friction.

Why this matters

Every consistency violation costs the user a re-learning. When they navigate from one screen to another and discover the "Done" button is now in the top-right instead of the bottom, they spend a moment relocating it; over thousands of interactions, those moments compound. When they learn that swipe-left dismisses in your inbox but swipe-left archives in your other lists, they have to remember which surface they're on before acting. When they form an expectation from external conventions ("X means Y here, like everywhere else") and you violate it, they're surprised, and surprise in interaction is almost always a cost.

The benefits of consistency compound in the other direction. Once a pattern is established, every additional surface that uses it gets the user's accumulated learning for free. A design system that's been used consistently for years means a new feature is half-learned before anyone touches it.

When to break consistency

Consistency is a means, not an end. There are good reasons to break it.

The two cases are genuinely different. A button that triggers a destructive action should be styled differently from a button that triggers a constructive one. A primary action should be visually weightier than a secondary action. A read-only display should not look like an editable field. These differences in styling reflect genuine differences in behavior and serve the user.

A new pattern is meaningfully better. If a new interaction pattern is significantly easier or faster than an existing one, introducing it for that case (and migrating the existing case toward it over time) is better than preserving consistency with a worse pattern. The cost of inconsistency is paid temporarily; the benefit of the better pattern accrues forever.

The context demands it. A "Save" button in a quick-edit modal should usually live in the modal, even if "Save" lives in the toolbar everywhere else. Local context overrides global pattern when the local case is self-contained.

These breaks should be deliberate. The failure mode is breaking consistency by accident — through hand-off losses, quick fixes, or different teams making uncoordinated decisions — without the rationale that would justify it.

Diagnosing consistency problems

A few symptoms suggest a consistency problem worth fixing.

Users hesitate at familiar-looking controls. They reach for a button that looks like one they've used before, then pause to verify what it does. The visual consistency is misleading them about functional consistency.

Documentation needs to explain "in this screen" exceptions. "On the dashboard, the search box uses syntax X; on the settings page, it uses syntax Y." Documentation for inconsistencies is a smell — it papers over a problem that should be fixed at the design level.

Users complete the same task differently in different parts of the product. The same operation is achievable through inconsistent paths. Users build different mental models for what should be one thing.

New features feel "unlike the rest of the product." When a new screen visibly came from outside the design system — different typography, different button styling, different spacing — it stands out as not belonging. This is internal aesthetic consistency failing.

Sub-skills in this cluster

  • consistency-internal — Maintaining consistency within your own product: design systems, component libraries, audit and enforcement, handling legacy patterns.
  • consistency-external — Honoring conventions from outside your product: platform conventions, category conventions, when to follow vs. when to lead.

Worked examples

A multi-platform product

A productivity tool ships native apps for iOS, Android, web, and desktop. Each platform has its own conventions: iOS expects bottom tabs, Android expects a navigation drawer, web expects a top nav. Forcing one navigation pattern across all platforms violates external consistency on three of them. Honoring each platform's conventions violates internal consistency across the company's product.

The right tradeoff is usually to honor external conventions (platform-native navigation patterns) while keeping internal consistency in everything that's the user's content (data model, terminology, workflows). The chrome adapts; the substance is consistent.

Show full SKILL.md (763 more words)Show less
Two confirmation patterns in one product

A product has two confirmation flows. In one, deleting an item shows a modal: "Delete this? Cancel / Delete." In the other, deleting shows an inline confirm: "Are you sure?" with Yes/No buttons appearing where the original button was. Both work. But users encountering the second flow after the first are momentarily confused — the action is the same but the interface is different.

The fix: pick one pattern (the modal, if the action is high-stakes; the inline if it's low-stakes) and apply it consistently for all confirmations of similar weight. If two different weights of confirmation actually deserve different treatments, distinguish them deliberately and document the rule.

A button styling drift

Over time, a product accumulates buttons in seven different shades of blue, three different border-radius values, and two different padding scales. Each individual choice was made in good faith — a designer fixing a specific issue, an engineer matching a design they had at hand — but the accumulated drift is visible. Users don't have a single "primary action" visual to learn; instead they see a sea of similar-but-not-identical buttons.

The fix: a design-system audit, consolidating the variants down to a small set with clear semantic roles. Then ongoing enforcement (linting, design reviews) to prevent re-drift.

Inventing a new pattern when a convention exists

A team designs a search interface using a custom icon and a custom keyboard shortcut, ignoring the magnifying glass and Cmd-F that users expect. The team's reasoning: "Our icon is more on-brand, and Cmd-F is taken by our other feature." The result: users don't recognize the search affordance and can't find the shortcut. External consistency would have served them better even at some brand cost.

The fix: use the convention. If you really need to take Cmd-F for something else, find a different shortcut — but the search itself should look like search.

Honoring a convention while extending it

A messaging product uses the standard send-on-Enter convention. They want to add the option to send on Cmd-Enter for users who prefer to use Enter for new lines. The right pattern is to honor both: Enter sends by default (matching the convention), and a setting lets users switch to Cmd-Enter (extending the convention). Users who don't change the setting get the expected behavior; users who switch get a workflow that matches their preference.

This is consistency that honors external conventions while accommodating differences — the right balance.

When the principle is misapplied

Consistency for its own sake. Forcing every screen into the same template even when the screens have meaningfully different content. The result is a product that's coherent but bland; the visual rhythm doesn't reflect the actual variety of content.

Aesthetic consistency masking functional inconsistency. Two buttons that look identical (same color, same size, same icon style) but behave differently. The user learns the visual pattern and is then surprised when behavior doesn't match. Visual identity is a strong implicit promise of behavioral identity; honor it.

External consistency that actively hurts the user. Some platform conventions are legacy and should be broken. Apple's "tap-and-hold for context menu" was historically inconsistent across apps and is still being normalized; in 2010, following the inconsistent convention was worse than picking a coherent pattern of your own. When a convention is genuinely bad and the cost of breaking it is small, do.

Premature consistency. Locking down patterns too early in a product's life, before you know which patterns work. Better to allow some inconsistency in early development and consolidate as patterns prove themselves than to enforce consistency around patterns that turn out to be wrong.

Heuristic checklist

Before making a design decision, ask: Does an existing pattern in our product serve this case? If yes, use it. Does an external convention serve this case? If yes, use it unless you have a strong reason not to. If I'm departing from an existing pattern, is the new approach genuinely better, or am I just reinventing? If the latter, stop. If two cases look the same, do they behave the same? If not, distinguish them visually so users can predict behavior.

  • Mental Model — consistency lets users transfer their mental model across surfaces.
  • Mapping — consistent mappings reinforce each other; inconsistent ones interfere.
  • Recognition Over Recall — consistency strengthens recognition by stabilizing patterns.
  • Affordance — consistent affordances mean users can predict what's interactive.
  • Mimicry — consistency with external conventions is one form of mimicry.
  • Iconic Representation — consistent icon use across the product builds recognition.

See also

  • references/lineage.md — origins in HCI, design systems literature, and platform conventions.
  • consistency-internal/ — sub-skill on internal consistency.
  • consistency-external/ — sub-skill on external consistency.

© hashgraph-online, Apache-2.0. 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 1 other file (references) in plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/consistency of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/lineage.md

Open the folder on GitHubat commit 78497e5

Compare with similar skills

Consistency 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.

Consistency compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Consistency this skillhashgraph-online/awesome-codex-plugins1.2k—~3.2kAutomated safety check: PassApache-2.0
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Figma Design System Builderwarpdotdev/warp65k2 repos~4.4kAutomated safety check: PassAGPL-3.0
Figma use_figma Plugin API Ruleswarpdotdev/warp65k4 repos~4.4kAutomated safety check: PassAGPL-3.0
UI StylingOhh-889/skyroc79513 repos~2.5kAutomated safety check: PassMIT
Shadcnsupabase/evals14342 repos~4.5kAutomated safety check: PassApache-2.0

Similar skills

  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.

    65k GitHub starsUsed in 4 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • UI Styling

    Ohh-889/skyroc

    Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs.

    795 GitHub starsUsed in 13 repos~2.5k tokens
    Frontend & DesignAuto-check passed
  • Shadcn

    supabase/evals

    Official

    Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI.

    143 GitHub starsUsed in 42 repos~4.5k tokens
    Frontend & DesignAuto-check passed
  • Design System

    Ohh-889/skyroc

    Token architecture, component specifications, and slide generation.

    795 GitHub starsUsed in 11 repos~1.7k tokens
    Frontend & DesignAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 686 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated today
    Auto-check passed
  • Manuscript Engagement Analytics

    hashgraph-online/awesome-codex-plugins

    Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…

    1.2k GitHub stars~875 tokensUpdated today
    Auto-check passed

Questions about Consistency

What does Consistency do?

Apply the principle of Consistency — making similar things look and behave similarly so users can transfer learning across the interface. Consistency is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the principle of Consistency — making similar things look and behave similarly so users can transfer learning across the interface.

When should I use Consistency?

Consistency fits situations like: designing component libraries; defining naming conventions; choosing whether to invent; borrow patterns.

How do I install Consistency in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill consistency -a claude-code`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/consistency in hashgraph-online/awesome-codex-plugins) into .claude/skills/consistency in your project. Claude Code loads it when a task matches its description.

How do I install Consistency in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill consistency -a codex`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/consistency in hashgraph-online/awesome-codex-plugins) into .agents/skills/consistency in your project. Codex loads it when a task matches its description.

Can I use Consistency 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 hashgraph-online/awesome-codex-plugins --skill consistency -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/consistency, .gemini/skills/consistency, .github/skills/consistency and .opencode/skills/consistency in your project.

What does Consistency need to run?

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

Does Consistency 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 Consistency 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 Consistency use?

Consistency is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Consistency use?

About 3.2k tokens (SKILL.md is roughly 13k 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 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Consistency?

Skills that share tags, products or a category with Consistency: Impeccable (bestofjs/bestofjs, 3.1k stars), Figma Design System Builder (warpdotdev/warp, 65k stars), Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars) and UI Styling (Ohh-889/skyroc, 795 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Consistency?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,242 GitHub stars. The repository holds 686 skills in this directory. The repository was last updated on October 8, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.