Home / hoangnguyen0403 / agent-skills-standard · .claude/skills/system-design/system-design-estimation/SKILL.md · GitHub

system-design-estimation skillA

system-design-estimation is agent-read markdown (skill) from hoangnguyen0403/agent-skills-standard: Compute defensible capacity numbers before architecture: average and peak QPS, storage growth, bandwidth, working-set memory, latency and availability budgets. Use when sizing a service, provisioning infrastructure, or checking that a design survives peak load..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Capacity Estimation

## **Priority: P1 (HIGH)**

Estimate before you architect. One order of magnitude decides cache, shard, and queue choices.

## Core Formulas

- `average QPS = DAU x actions per user per day / 86,400`
- `peak QPS = average QPS x peak factor` (default 5x; 20-100x for flash sale, ticket drop, or scheduled push)
- `storage per year = writes per day x record size x 365 x replication factor`
- `bandwidth = QPS x payload size` (compute ingress and egress separately)
- `working set = hot records x record size`, where hot is typically 20% of data serving 80% of reads
- `connections = concurrent users x connections per user`; compare against pool and file-descriptor limits

## Method

1. Round every input to one significant figure. Precision here is false precision.
2. Compute average, then peak, then storage, then bandwidth, then memory.
3. Compare each result to a known ceiling from [estimation numbers](references/estimation-numbers.md): single-node QPS, disk IOPS, NIC throughput, RAM per instance.
4. Name the **shaping quantity** - the first number that breaks a single-node ceiling. It dictates the first component added in high-level design.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add hoangnguyen0403/agent-skills-standard/system-design-estimation@git:20260830.00e03f4
Exact content
mdr add hoangnguyen0403/agent-skills-standard/system-design-estimation@sha256:9fccdf2f44004b0b

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jst2qpvod5txpq26.svg)](https://markdownregistry.com/a/art_jst2qpvod5txpq26)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260830.00e03f4 latest2026-08-30 00e03f4 3,686 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3686 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hoangnguyen0403/agent-skills-standard · 571 stars · license MIT · pushed 2026-09-24 · branch develop

API

GET https://markdownregistry.com/api/v1/artifacts/art_jst2qpvod5txpq26
GET https://markdownregistry.com/api/v1/resolve?ref=hoangnguyen0403/agent-skills-standard/system-design-estimation
GET https://markdownregistry.com/api/v1/blob/9fccdf2f44004b0b35032f7a4b6d81655118f62cd16904950e9a8bc9e8f8b3ce

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from hoangnguyen0403/agent-skills-standard

caveman-commit skill
hoangnguyen0403/agent-skills-standard · .agents/skills/caveman-commit/SKILL.md · Ultra-compressed commit message generator. Cuts noise from commit messages while preserving intent and reasoning…
git:20260509.3e36716 · audit A · 571 stars
caveman-compress skill
hoangnguyen0403/agent-skills-standard · .agents/skills/caveman-compress/SKILL.md · Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens…
git:20260509.3e36716 · audit A · 571 stars
caveman-review skill
hoangnguyen0403/agent-skills-standard · .agents/skills/caveman-review/SKILL.md · Ultra-compressed code review comments. Cuts noise from PR feedback while preserving the actionable signal. Each comment…
git:20260509.3e36716 · audit A · 571 stars
caveman skill
hoangnguyen0403/agent-skills-standard · .agents/skills/caveman/SKILL.md · Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical…
git:20260509.3e36716 · audit A · 571 stars
common-architecture-diagramming skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-architecture-diagramming/SKILL.md · Draw architecture diagrams as editable draw.io files with a fixed house style, C4 levels, and evidence-tagged shapes…
git:20260913.58fa467 · audit A · 571 stars
common-best-practices skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-best-practices/SKILL.md · Enforce SOLID principles, guard-clause style, function size limits, and intention-revealing naming across all…
git:20260714.6bf9b5e · audit A · 571 stars
common-business-requirements skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-business-requirements/SKILL.md · Standardize BRD and BRD-lite discovery for business goals, stakeholder impact, current-to-future state, and measurable…
git:20260704.611f52a · audit A · 571 stars
common-code-review skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-code-review/SKILL.md · Conduct high-quality, persona-driven code reviews. Use when reviewing PRs, critiquing code quality, or analyzing…
git:20260714.6bf9b5e · audit A · 571 stars
common-context-optimization skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-context-optimization/SKILL.md · Maximize context window efficiency, reduce latency, and prevent lost-in-middle issues through strategic masking and…
git:20260714.6bf9b5e · audit A · 571 stars
common-dast-tooling skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-dast-tooling/SKILL.md · Standardize dynamic application security testing for backend APIs, frontend web apps, and mobile clients. Covers ZAP…
git:20260714.6bf9b5e · audit A · 571 stars
common-debugging skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-debugging/SKILL.md · Troubleshoot systematically using the Scientific Method. Use when debugging crashes, tracing errors, diagnosing…
git:20260714.6bf9b5e · audit A · 571 stars
common-documentation skill
hoangnguyen0403/agent-skills-standard · .agents/skills/common/common-documentation/SKILL.md · Write effective code comments, READMEs, and technical documentation following intent-first principles. Use when adding…
git:20260714.6bf9b5e · audit A · 571 stars

Every file in hoangnguyen0403/agent-skills-standard

Other files named system-design-estimation

system-design-estimation skill
hoangnguyen0403/agent-skills-standard · .agents/skills/system-design/system-design-estimation/SKILL.md · Compute defensible capacity numbers before architecture: average and peak QPS, storage growth, bandwidth, working-set…
git:20260830.00e03f4 · audit A · 571 stars

Browse by kind, by grade A, or by owner.