Agent skill

Ockhams Equivalent Designs

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Identify when two design options are functionally equivalent so the razor can be applied.

Apache-2.0Auto-check passed

Install Ockhams Equivalent Designs

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

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins ockhams-equivalent-designs --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/process-and-robustness-principles/skills/ockhams-equivalent-designs .claude/skills/ockhams-equivalent-designs && 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
ockhams-equivalent-designs
GitHub stars
1.3k
Token cost
~2.3k tokens
SKILL.md length
1,222 words
Files
2 (incl. references)
Skills in repo
714
Repo updated
First seen
Licence
Apache-2.0

At a glance

Identify when two design options are functionally equivalent so the razor can be applied.

  • Comparing design alternatives
  • SKILL.md covers Defining functional equivalence, When designs that look…, When complexity actually earns… and Evaluating equivalence honestly, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Evaluating whether two implementations of a feature actually produce the same outcome

What it does

Ockhams Equivalent Designs is an agent skill from hashgraph-online/awesome-codex-plugins. Identify when two design options are functionally equivalent so the razor can be applied. Use when comparing design alternatives, evaluating whether two implementations of a feature actually produce the same outcome, or recognizing that a complex solution doesn't earn its place against a simpler one. Most design debates involve actual tradeoffs; the razor only cuts when the alternatives genuinely produce equivalent results. The skill is identifying equivalence honestly rather than rationalizing complexity.

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

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

  • Comparing design alternatives
  • Evaluating whether two implementations of a feature actually produce the same outcome
  • Recognizing that a complex solution doesnt earn its place against a simpler one

Example prompts

  • “/ockhams-equivalent-designs”

What it can do on your machine

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

Ockhams Equivalent Designs loads about 2.3k tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 135 tokens; SKILL.md has 1,222 words of instructions outside code blocks.

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

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 9e7b281, republished under its Apache-2.0 licence (© hashgraph-online). 1,222 words, ~2,277 tokens.

Download SKILL.mdSave it as .claude/skills/ockhams-equivalent-designs/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
ockhams-equivalent-designs
description
Identify when two design options are functionally equivalent so the razor can be applied. Use when comparing design alternatives, evaluating whether two implementations of a feature actually produce the same outcome, or recognizing that a complex solution doesn't earn its place against a simpler one. Most design debates involve actual tradeoffs; the razor only cuts when the alternatives genuinely produce equivalent results. The skill is identifying equivalence honestly rather than rationalizing complexity.

Ockham's Razor — equivalent designs

The razor cuts when alternatives are functionally equivalent. The skill is recognizing when alternatives actually are equivalent — versus when a more complex alternative serves a real need that the simpler one doesn't.

Designers and engineers often defend complexity by imagining benefits the complex solution provides. Sometimes those benefits are real; sometimes they're rationalization. The discipline is honest evaluation of whether the complexity earns its place.

Defining functional equivalence

Two designs are functionally equivalent when they produce the same outcome for users. Specifically:

Same goal achieved. The user can accomplish what they're trying to accomplish.

Same quality of outcome. The result is equally good (correct, complete, accurate).

Same cost to user. The user pays roughly the same in time, attention, learning.

Same edge case handling. Both work for the cases users actually encounter.

Same downstream effects. Both leave the system in the same state for subsequent interactions.

If these are equal, the designs are equivalent for the user, and the razor cuts toward simpler.

When designs that look equivalent aren't

Designs may look equivalent on the surface but actually differ in important ways:

Edge case behavior. One design handles unusual cases gracefully; the other fails. The behavior in the typical case is the same; the long tail differs.

Performance. One design is fast at small scale; the other scales better at large scale. Both work today; the difference matters tomorrow.

Error recovery. One design recovers from failures elegantly; the other doesn't. Most of the time, neither fails; in the failure cases, they differ sharply.

Discoverability. Two designs achieve the same task, but one is more discoverable. Users find one and not the other.

Accessibility. Two designs work for typical users; one fails for users with disabilities.

Internationalization. Two designs work in English; one fails in non-English contexts.

Future flexibility. Two designs do the same thing today; one is easier to evolve.

When evaluating equivalence, check these dimensions, not just the happy path.

When complexity actually earns its place

A more complex design earns its place when it:

Solves a real problem the simpler doesn't. Not a hypothetical problem; an actual user pain point with evidence.

Serves an important audience the simpler doesn't. Even if the audience is small, if it's strategically important, the complexity may be justified.

Enables future capabilities. Architectural complexity that supports planned future work, not speculative future work.

Improves reliability or performance materially. Not in theory; in measurement.

Reduces other complexity. Sometimes adding one component eliminates several others. The net change is simplification.

If none of these apply, the complexity doesn't earn its place.

Evaluating equivalence honestly

Engineers and designers tend to defend their preferred designs. Honest equivalence evaluation requires:

Defining "the user's goal" specifically. Vague goals make any solution look reasonable. Precise goals make tradeoffs visible.

Listing the actual differences. What does design A do that B doesn't? What does B do that A doesn't? Be specific.

Quantifying the differences. Not "A is faster" — "A handles 1000 req/sec, B handles 5000." Numbers force honesty.

Identifying who pays for the differences. Often complexity benefits some users (or the team) and costs others. Be explicit.

Time-shifting the comparison. Today, the simpler design may be sufficient. In two years, the more complex one may be necessary. Make the time horizon explicit.

Worked examples

Two API designs that look equivalent

Option A: A single endpoint that takes a complex JSON body specifying everything.

Option B: Multiple endpoints, each with simpler parameters.

At first they look equivalent — both expose the same functionality. But:

  • Option A is harder to document (the complex body has many fields).
  • Option B has more endpoints to maintain.
  • Option A has more validation logic for the body.
  • Option B is easier for clients to understand piecemeal.
  • Option A allows transactional behavior (one call); Option B doesn't.

If transactional behavior matters, A wins. If documentation and approachability matter more, B wins. They're not equivalent; pick based on what matters.

Two feature implementations that are equivalent

Option A: A wizard with 3 steps to configure a new resource.

Option B: A single page with the same fields shown all at once.

Both produce the same configured resource. The user experience differs (wizard vs. single page) but the outcome is the same.

For a complex configuration with many interdependent decisions, the wizard helps the user; A is preferred. For a simple configuration with few fields, the single page is faster; B is preferred.

If the configuration is genuinely simple, A's complexity doesn't earn its place. The razor cuts toward B.

Show full SKILL.md (469 more words)Show less
Two architecture choices

Option A: A microservices architecture with 12 services.

Option B: A monolithic architecture in a single codebase.

If the team is small and the throughput modest, A's complexity (network, deployment, monitoring) doesn't earn its place against B's simplicity. The razor cuts toward B.

If the team is large with many independent groups, A's complexity may be justified by the parallelization it enables. The razor doesn't cut — they're not equivalent for this team.

The right call depends on context. The discipline is to honestly evaluate the context, not to default to either.

Two visual treatments

Option A: Detailed icons with multiple colors and gradients.

Option B: Simple line icons in a single color.

Both can communicate the same information. Option A may have aesthetic appeal but doesn't communicate more. Option B is faster to render, easier to maintain (consistent stroke weights), more flexible (color from currentColor), and more accessible (high contrast).

The razor cuts toward B unless A's aesthetic is genuinely strategic to the brand. Even then, A should earn its place against the costs.

A complex feature defended on hypotheticals

Engineering team proposes a complex configuration system: "Users will want to customize this in the future." Current users don't ask for it; no design pressure for it; speculative future need.

The razor cuts: don't build it now. If future need materializes, build it then. YAGNI (You Aren't Gonna Need It). Premature flexibility is a common form of accumulated complexity.

Anti-patterns

Defending complexity with hypotheticals. "We might need this someday." Without evidence, the complexity isn't earning its place.

Equivalence claims without checking edge cases. Two designs equivalent on the happy path may differ sharply on the long tail.

Dismissing simpler options because they "feel less professional." Aesthetic preference for complexity doesn't earn complexity's place.

Failing to time-shift the evaluation. Today's equivalence may not be tomorrow's. Long-lived systems deserve longer-horizon evaluation.

Confusing "more features" with "better." Complexity isn't quality. A focused product can be better than a sprawling one.

Comparing designs that aren't actually equivalent. Apples and oranges. Pick designs that achieve the same goal, then evaluate the differences.

Heuristic checklist

When considering two designs, ask: What's the specific user goal each design serves? Be precise. Are they actually equivalent on the goal? Not just the happy path; check edge cases, accessibility, scaling. What are the differences? List specifically. What does the complexity earn? Should be a real, measurable benefit. What does the complexity cost? Cognitive, maintenance, evolution. If equivalent, choose simpler. If not, the razor doesn't apply.

  • ockhams-razor — parent principle on preferring simpler designs.
  • ockhams-feature-pruning — sibling skill on removing accumulated complexity.
  • form-follows-function — closely related; both ask whether each design element earns its place.
  • iteration — equivalence evaluation evolves over time as you learn more about user needs.

See also

  • references/comparison-template.md — a template for honest design comparison.

© 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/process-and-robustness-principles/skills/ockhams-equivalent-designs of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/comparison-template.md

Open the folder on GitHubat commit 9e7b281

Compare with similar skills

Ockhams Equivalent Designs 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.

Ockhams Equivalent Designs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ockhams Equivalent Designs this skillhashgraph-online/awesome-codex-plugins1.3k—~2.3kAutomated safety check: PassApache-2.0
Design Systemaffaan-m/ECC276k—~698Automated safety check: PassMIT
Design Guidepaperclipai/paperclip99k1 repos~3.1kAutomated safety check: PassMIT
Design Audit Against Rams' Principlesthedotmack/claude-mem99k—~4.6kAutomated safety check: PassApache-2.0
Figma Design to Codewarpdotdev/warp65k4 repos~2.9kAutomated safety check: PassAGPL-3.0
Design Consultationgarrytan/gstack136k—~15kAutomated safety check: NotesMIT

Similar skills

  • Design System

    affaan-m/ECC

    Generate a design system from an existing codebase or audit one for visual consistency: extract tokens (colors, typography, spacing, shadows) into design-tokens.json and CSS custom properties with…

    276k GitHub stars~698 tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Design Guide

    paperclipai/paperclip

    Paperclip UI design system guide for building consistent, reusable frontend components.

    99k GitHub starsUsed in 1 repo~3.1k tokens
    Frontend & DesignAuto-check passed
  • Audits a design against Dieter Rams' ten principles of good design, scores each with evidence, and hands off a make-plan prompt for a new, refined or redesigned outcome.

    99k GitHub stars~4.6k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Figma Design to Code

    warpdotdev/warp

    Turns a Figma frame or component into production code that matches the design, using the Figma MCP server and the project's own design system.

    65k GitHub starsUsed in 4 repos~2.9k tokens
    Frontend & DesignAuto-check passed
  • Design Consultation

    garrytan/gstack

    Learns about your product, studies the landscape and writes a DESIGN.md with a full design system covering type, color, layout, spacing and motion.

    136k GitHub stars~15k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • Product Design Workflow Bundle

    XiaomiMiMo/MiMo-Code

    Entry point to a bundle of product design workflows covering context, research, audits, ideation, URL or image to code, design QA and sharing a prototype.

    14k GitHub stars~721 tokensUpdated today
    Frontend & DesignAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 714 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.3k 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.3k 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.3k 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.3k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~2.9k 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.3k GitHub stars~618 tokensUpdated today
    Auto-check passed

Questions about Ockhams Equivalent Designs

What does Ockhams Equivalent Designs do?

Identify when two design options are functionally equivalent so the razor can be applied. Ockhams Equivalent Designs is an agent skill from hashgraph-online/awesome-codex-plugins. Identify when two design options are functionally equivalent so the razor can be applied.

When should I use Ockhams Equivalent Designs?

Ockhams Equivalent Designs fits situations like: comparing design alternatives; evaluating whether two implementations of a feature actually produce the same outcome; recognizing that a complex solution doesnt earn its place against a simpler one.

How do I install Ockhams Equivalent Designs in Claude Code?

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

How do I install Ockhams Equivalent Designs in Codex?

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

Can I use Ockhams Equivalent Designs 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 ockhams-equivalent-designs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ockhams-equivalent-designs, .gemini/skills/ockhams-equivalent-designs, .github/skills/ockhams-equivalent-designs and .opencode/skills/ockhams-equivalent-designs in your project.

What does Ockhams Equivalent Designs need to run?

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

Does Ockhams Equivalent Designs 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 Ockhams Equivalent Designs 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 Ockhams Equivalent Designs use?

Ockhams Equivalent Designs 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 Ockhams Equivalent Designs use?

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

What are the alternatives to Ockhams Equivalent Designs?

Skills that share tags, products or a category with Ockhams Equivalent Designs: Design System (affaan-m/ECC, 276k stars), Design Guide (paperclipai/paperclip, 99k stars), Design Audit Against Rams' Principles (thedotmack/claude-mem, 99k stars) and Figma Design to Code (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ockhams Equivalent Designs?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,255 GitHub stars. The repository holds 714 skills in this directory. The repository was last updated on October 9, 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.