Apply the principle of avoiding the Scaling Fallacy — the assumption that a system that works at one scale will work at a different (smaller or larger) scale.

Apache-2.0Auto-check passed

Install Scaling Fallacy

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

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

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

At a glance

Apply the principle of avoiding the Scaling Fallacy — the assumption that a system that works at one scale will work at a different (smaller or larger) scale.

  • Scaling a feature from prototype to production
  • SKILL.md covers Two kinds of scaling fallacy, Why this principle matters, Common scaling failures and Diagnosing scaling-fallacy risks, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Designing for an unfamiliar user volume

What it does

Scaling Fallacy is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the principle of avoiding the Scaling Fallacy — the assumption that a system that works at one scale will work at a different (smaller or larger) scale. Use when scaling a feature from prototype to production, designing for an unfamiliar user volume, evaluating whether a process that works for 10 users will work for 10,000, or planning a launch in a much larger market. Two distinct kinds: load assumptions (will it handle the volume?) and interaction assumptions (will users behave the same way?). Both need…

Its SKILL.md is about 2.9k 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`).

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

  • Scaling a feature from prototype to production
  • Designing for an unfamiliar user volume
  • Evaluating whether a process that works for 10 users will work for 10
  • Planning a launch in a much larger market

Example prompts

  • “/scaling-fallacy”

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

Scaling Fallacy loads about 2.9k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 140 tokens; SKILL.md has 1,617 words of instructions outside code blocks.

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

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,617 words, ~2,896 tokens.

Download SKILL.mdSave it as .claude/skills/scaling-fallacy/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
scaling-fallacy
description
Apply the principle of avoiding the Scaling Fallacy — the assumption that a system that works at one scale will work at a different (smaller or larger) scale. Use when scaling a feature from prototype to production, designing for an unfamiliar user volume, evaluating whether a process that works for 10 users will work for 10,000, or planning a launch in a much larger market. Two distinct kinds: load assumptions (will it handle the volume?) and interaction assumptions (will users behave the same way?). Both need testing at the actual scale.

Scaling Fallacy

Definition. The scaling fallacy is the tendency to assume that a system that works at one scale will also work at a different scale — usually larger, sometimes smaller. The assumption is wrong often enough that it's worth treating as a default suspect rather than a default expectation. Designs that work for 10 users frequently break for 10,000; designs that work for one team frequently fail for an entire company; mockups that look right on a single screen frequently fall apart in production data volumes.

The fallacy is named because it's so common in engineering and design discussions: "We've tested this with 5 users in a session and it works great" → "Therefore it will work at full launch volume." The inference is unwarranted. Scale changes things in two distinct ways: it changes the load on the system (volume of data, volume of users, volume of operations), and it changes the kinds of users and use cases the system encounters (broader audience, more diverse use cases, more edge cases).

Both kinds of change can break a design. The skill is anticipating which assumptions might fail at scale, testing them deliberately, and not assuming that small-scale success predicts large-scale success.

Two kinds of scaling fallacy

The Lidwell taxonomy distinguishes two kinds, and the distinction is useful.

Load assumptions. The system is asked to handle more (or sometimes less) data, traffic, transactions, or operations than it was designed for. Performance degrades, components fail, costs explode, infrastructure breaks.

Interaction assumptions. The user base grows or changes, encountering use cases, edge cases, and behaviors that weren't anticipated. Designs that worked for the original audience fail for a broader one.

Both are real; both deserve attention. Most scaling discussions focus on the first (will the servers handle it?) and underweight the second (will the design accommodate the new users?). The second is often the harder problem.

Why this principle matters

Scaling problems hurt because:

  • They appear suddenly and dramatically. A system that was fine at 10x load can fail catastrophically at 11x.
  • They're costly to fix in production. Re-architecting for scale after launch is much more expensive than designing for it initially.
  • They're invisible until they happen. Pre-launch testing rarely captures the actual production scale.
  • They're often non-linear. A 10x increase in users can produce a 100x increase in some operation (e.g., notifications, search queries, support tickets).

The discipline is to anticipate scaling problems before they bite, not to discover them in production.

Common scaling failures

Lists that work with 10 items and break with 10,000. A feed designed to display all items fails when "all" is now 10,000. Need pagination, virtualization, or filtering.

Search that works on a small corpus and fails on a large one. Linear search across 100 records is fine; across 100 million records, it's not. Need indexing.

Notifications that work for one user and overwhelm at scale. A "we'll send you an email when X happens" feature fine for individual users; toxic when X happens 10,000 times a day to a single user.

UI that works in mockup and breaks with real data. A design with placeholder text "User Name" works perfectly; the same design with "Dr. Jonathan Christopher Worthington-Smythe III" wraps awkwardly.

Workflow that works for 5 team members and fails for 500. A process that depends on "everyone reviewing each other's work" doesn't scale to large teams.

Pricing that works for one customer segment and fails for another. A free-tier model that scales to enterprise customers without limits is a financial disaster.

Feature discoverability that works for 10 features and breaks for 100. A "show all features in the navigation" approach is fine for small apps; it becomes overwhelming and unsearchable for large ones.

Diagnosing scaling-fallacy risks

Before assuming a system will scale, ask:

What's the actual scale we're targeting? Be specific. 10x current users? 100x? Across what time period?

Which components are linear vs. exponential in load? Some scale gracefully; others scale catastrophically.

What edge cases will become common at scale? A one-in-a-million event happens daily at scale-of-a-million.

What use cases will become more diverse? The new users will use the product in ways the original users didn't.

What dependencies have their own scaling limits? A third-party API with a 1000 req/sec limit doesn't help when you have 10,000 req/sec.

What design choices were made for the small case that won't survive the large? The "display everything" pattern fails at scale; the "manual moderation" pattern fails at scale; the "everyone gets notified" pattern fails at scale.

Sub-skills in this cluster

  • scaling-load-assumptions — Verifying and designing for load (data volume, traffic, transactions). Includes pagination, indexing, caching, queuing, rate limiting.
  • scaling-interaction-assumptions — Verifying and designing for user-base growth and diversity (edge cases, new use cases, broader audiences). Includes user-research at scale, feature-prioritization shifts, support patterns.

Worked examples

A feed that breaks at scale

A startup builds a feed showing all activity in a user's account. With early users (10–100 events per account), the feed loads instantly and is useful. As the product grows, accounts accumulate thousands of events. The feed takes 30 seconds to load, then crashes the browser.

The fix: pagination + virtualization (only render visible items) + filtering (let users find specific kinds of events). The original design assumed everything could be shown; at scale, "everything" is too much.

A notification system that overwhelms

A product sends an email when "something interesting" happens. For early users with one teammate and a few projects, "interesting things" happen weekly. For enterprise customers with 100 teammates and 50 projects, "interesting things" happen 100x per day. Users start ignoring all emails and the value is lost.

The fix: digest emails (batch into daily summaries), notification preferences (let users tune what's "interesting"), and intelligent filtering (machine learning to predict relevance). The original assumption of "low frequency = always notify" doesn't survive at scale.

Show full SKILL.md (651 more words)Show less
A user-name field that works in mockup

A design uses placeholder "Jane Doe" for user names. The design fits perfectly. In production, real names include long ones, hyphenated ones, ones with non-Latin characters, ones with diacritics, and titles. The design wraps awkwardly, breaks layout, or truncates important information.

The fix: design for variable name lengths and character sets from the start. Test with real-world name examples (long, short, multi-script, special characters). Don't assume placeholder = reality.

A team-collaboration feature for 5 members

A document tool's collaboration feature works wonderfully for 5 simultaneous editors: changes appear in real time, conflicts are rare, the cursor positions of others are visible. The same feature with 50 simultaneous editors becomes a flickering mess of cursors and conflicting changes.

The fix: design collaboration patterns that scale. Active vs. passive participation; section-based locking; awareness controls. The 5-person assumption doesn't survive.

A free tier that scales to enterprise

A SaaS product offers a generous free tier ("up to 1GB of storage, unlimited collaborators"). It works fine for individual users. Enterprise customers sign up under the free tier and use it for hundreds of employees, costing the company more in infrastructure than they could ever charge.

The fix: tier-based limits that scale with usage. Pricing tiers that grow with the customer's actual cost to serve. The "unlimited" assumption doesn't survive enterprise.

A search that breaks beyond a million records

A simple full-text search over a database table is fine for 1,000 records. At 1 million records, queries take 30 seconds. At 100 million, queries time out entirely.

The fix: dedicated search infrastructure (Elasticsearch, Algolia, or similar). The query patterns also need to change — fuzzy matching, ranking, filtering all become essential. The "just search the table" assumption doesn't survive scale.

Anti-patterns

"It works in dev, ship it." Local testing rarely captures production scale. Pre-launch testing should explicitly target production-scale data and load.

Assuming linear scaling. "If it works for 100 users, it'll work for 100,000 because we'll just add 1000x more servers." Many systems have non-linear scaling characteristics; doubling load doesn't always require doubling capacity.

Ignoring the long tail. "Most users will only have a few items." True, but the few users with many items will have a terrible experience, and they're often your most valuable customers.

Designing for the median user. The median experience may be fine; the experience for users at the upper extreme of usage may be broken.

Underestimating diversity at scale. "Our users are all engineers in their 30s in San Francisco." At scale, your users will be retirees in Korea, students in Brazil, and professionals across the entire spectrum of jobs and circumstances. The original audience assumptions don't survive.

Optimizing only for current scale. A system optimized aggressively for current 10K users may be hard to re-architect for 1M. Plan for the next 10x even if you're not there yet.

Heuristic checklist

When designing a system or feature, ask: What scale am I targeting in 6 months? In 2 years? Be specific. Which components scale linearly, and which non-linearly? Identify the non-linear ones and stress-test them. What edge cases will become common at scale? A 0.01% event happens daily at scale-of-a-million. What user diversity will I encounter? New users will be different from current users. Have I tested at the actual target scale, or just smaller? Small-scale testing doesn't predict large-scale behavior.

  • Weakest Link — at scale, weak links surface that were invisible at small scale.
  • Factor of Safety — design with margin for the scale you might reach, not just the scale you have.
  • 80/20 Rule — at scale, the 80% may behave very differently from at small scale.
  • Iteration — scaling-fallacy mistakes are usually only correctable through iteration.
  • Errors — error rates that are tolerable at small scale become unacceptable at large scale.

See also

  • references/lineage.md — origins in engineering, biology, and software systems.
  • scaling-load-assumptions/ — sub-skill on load and capacity scaling.
  • scaling-interaction-assumptions/ — sub-skill on user-base and behavioral scaling.

© 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/scaling-fallacy of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/lineage.md

Open the folder on GitHubat commit 9e7b281

Compare with similar skills

Scaling Fallacy 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.

Scaling Fallacy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scaling Fallacy this skillhashgraph-online/awesome-codex-plugins1.3k—~2.9kAutomated safety check: PassApache-2.0
Avoid Acting On Assumptionsaiming-lab/MetaClaw3.5k—~214Automated safety check: PassMIT
Principle Redesign From First Principlescursor/plugins10k8 repos~211Automated safety check: PassNone
Autofocus Avoidancethedaviddias/Front-End-Checklist74k—~508Automated safety check: PassMIT
Scale Benchmarkssickn33/agentic-awesome-skills47k1 repos~1.4kAutomated safety check: PassMIT
Uxui Principlessickn33/agentic-awesome-skills47k2 repos~548Automated safety check: PassMIT

Similar skills

  • Avoid Acting On Assumptions

    aiming-lab/MetaClaw

    Common mistake — proceeding with assumptions about ambiguous requirements instead of asking a clarifying question first.

    3.5k GitHub stars~214 tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Autofocus Avoidance

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Avoid autofocus on form fields.

    74k GitHub stars~508 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Scale Benchmarks

    sickn33/agentic-awesome-skills

    Reference document for monopoly scale-benchmarks. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 1 repo~1.4k tokens
    DatabasesAuto-check passed
  • Uxui Principles

    sickn33/agentic-awesome-skills

    Evaluate interfaces against 168 research-backed UX/UI principles, detect antipatterns, and inject UX context into AI coding sessions.

    47k GitHub starsUsed in 2 repos~548 tokens
    Auto-check passed
  • Qdrant Scaling

    github/awesome-copilot

    Official

    Guides Qdrant scaling decisions. An agent skill from github/awesome-copilot.

    40k GitHub starsUsed in 1 repo~467 tokens
    DatabasesAuto-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 Scaling Fallacy

What does Scaling Fallacy do?

Apply the principle of avoiding the Scaling Fallacy — the assumption that a system that works at one scale will work at a different (smaller or larger) scale. Scaling Fallacy is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the principle of avoiding the Scaling Fallacy — the assumption that a system that works at one scale will work at a different (smaller or larger) scale.

When should I use Scaling Fallacy?

Scaling Fallacy fits situations like: scaling a feature from prototype to production; designing for an unfamiliar user volume; evaluating whether a process that works for 10 users will work for 10; planning a launch in a much larger market.

How do I install Scaling Fallacy in Claude Code?

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

How do I install Scaling Fallacy in Codex?

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

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

What does Scaling Fallacy need to run?

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

Does Scaling Fallacy 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 Scaling Fallacy 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 Scaling Fallacy use?

Scaling Fallacy 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 Scaling Fallacy use?

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

What are the alternatives to Scaling Fallacy?

Skills that share tags, products or a category with Scaling Fallacy: Avoid Acting On Assumptions (aiming-lab/MetaClaw, 3.5k stars), Principle Redesign From First Principles (cursor/plugins, 10k stars), Autofocus Avoidance (thedaviddias/Front-End-Checklist, 74k stars) and Scale Benchmarks (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scaling Fallacy?

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.