scalability-analysis

scalability-analysis is a skill for Claude Code from aneja5/forge-skills. It costs 61 tokens per session (1,429 once invoked), scanned A, original, MIT.

A workflow for examining how an application will behave as usage grows. It identifies bottlenecks, scaling options, migration points, and likely costs at defined growth levels.

In plain words
What is it for?
Use it for capacity planning, cost projections, finding the next bottleneck, and deciding when to move from a monolith to distributed services.
Why use it?
It replaces vague guesses about whether a system will scale with specific risks and decision points before production traffic exposes them.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the forge-skills plugin — 42 skills, 36 commands, 1 hook shipped together

Good fit Use it for capacity planning, cost projections, finding the next bottleneck, and deciding when to move from a monolith to distributed services.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/aneja5/forge-skills/scalability-analysis
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add aneja5/forge-skills --skill scalability-analysis
Clone the repo
git clone --depth 1 https://github.com/aneja5/forge-skills

Made for: Claude Code.

Or install forge-skills, the plugin that ships this one along with the rest of its 42 skills, 36 commands, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for scalability-analysis

README.md
[![agentmods](https://agentmods.dev/badge/skills/aneja5/forge-skills/scalability-analysis/github.svg)](https://agentmods.dev/skills/aneja5/forge-skills/scalability-analysis)
Your own site
<a href="https://agentmods.dev/skills/aneja5/forge-skills/scalability-analysis"><img src="https://agentmods.dev/badge/skills/aneja5/forge-skills/scalability-analysis/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for scalability-analysis

Your own site · 80×15
<a href="https://agentmods.dev/skills/aneja5/forge-skills/scalability-analysis"><img src="https://agentmods.dev/badge/skills/aneja5/forge-skills/scalability-analysis.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 61 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,429 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00061 $0.01429
Opus 5 $0.00030 $0.00714
Sonnet 5 $0.00012 $0.00286
Haiku 4.5 $0.00006 $0.00143

Measured 5d ago against content hash 3fcf36e118e5, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

scalability-analysis scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/scalability-analysis/SKILL.md · 132 lines

How it starts

The opening of the file, as written. The whole thing — 132 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Scalability Analysis

Overview

Read .forge/architecture.md and produce .forge/scalability.md — a component-by-component analysis of where the system breaks under load, what it costs to scale, and when to migrate to different approaches. Every number must be specific, not "it depends."

When to Use

  • .forge/architecture.md exists and the system is approaching production
  • User asks "what breaks at 10x" or "how much will this cost at scale"
  • Investor pitch requires scalability story with real numbers
  • Need to decide between scale-up and scale-out strategies

When NOT to Use

  • No architecture exists — run architecture-and-contracts first
  • System is pre-MVP with zero users — premature optimization
  • Performance issue in existing code — use debugging-and-recovery

Common Rationalizations

Thought Reality
"We'll scale when we need to" Scaling decisions made under pressure are expensive. Plan the triggers now
"The cloud scales automatically" Auto-scaling has limits, costs, and cold-start penalties. Know them
"We can always add more servers" Not every bottleneck is CPU. Databases, third-party APIs, and network have different constraints
"Cost projections are too speculative" Use current pricing × growth multiplier. Wrong by 2x is better than no estimate
"We'll migrate to microservices later" Define the trigger now. "Later" never comes without a specific threshold

Red Flags

  • Component analysis says "scales horizontally" without identifying the bottleneck that prevents it
  • Cost projections use optimistic growth without conservative alternative
  • No mention of database scaling strategy (the most common bottleneck)
  • Migration triggers are vague ("when it gets slow") instead of specific ("when p99 latency exceeds 500ms")
  • Third-party API rate limits not accounted for
  • No data lifecycle policy (data grows forever = costs grow forever)

Core Process

Step 1: Document current capacity

Read the full file on GitHub · 132 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 132 lines · 61 tokens per session scan A 3fcf36e118e5

Subscribe to this mod's changes

scalability-analysis is a skill published in the GitHub repository aneja5/forge-skills (3 stars, last pushed 3mo ago), licensed MIT. It adds 61 tokens to every session and 1,429 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

activate-site

Activates and provisions a Power Pages website in a Power Platform environment via the Power Platform REST API. Use when the user wants to activate, provision, turn on, or enable a Power Pages website or portal.

microsoft/power-platform-skills · 45 tokens

deploy-site

Deploys an existing Power Pages code site to a Power Pages environment using PAC CLI. Handles tooling verification, authentication, environment confirmation, building, and uploading. Use when the user wants to deploy, upload, or publish their code site.

microsoft/power-platform-skills · 50 tokens

deploy

Builds and deploys a Power Apps code app to Power Platform. Use when deploying changes, redeploying an existing app, or pushing updates.

microsoft/power-platform-skills · 32 tokens

link-ticket-to-session

Link the current Claude Code session to a ticket (Linear, Jira, GitHub Issues, or GitHub Pull Requests) and cache its title/status in karma. Use when the user explicitly asks to link, attach, associate, or connect this session to a ticket, issue, or PR — e.g. "/link-ticket-to-session ABC-123", "link this session to…

JayantDevkar/claude-code-karma · 91 tokens

stack-baseline

The pinned default technology stack for SMB Product-Builder products. One source of truth so the architect, app-scaffolder, auth-engineer, and senior-dev never re-decide the stack per build — they build ON it. Covers framework, ORM/DB, auth, UI, payments/email/SMS, files, jobs, testing, hosting, and observability…

avelikiy/great_cto · 126 tokens

forge-cost-optimizer

Optimizes Atlassian Forge apps to reduce platform consumption and avoid unnecessary costs using Atlassian's "Optimise Forge platform costs" guidance. Use when the user asks to optimize Forge app costs, reduce Forge invocations, lower GB-seconds, reduce storage or log usage, tune memory, replace polling, improve…

atlassian/forge-skills · 137 tokens