System Design From Scratch

Design a backend or distributed system by building a tiny but real working version of it, proving its properties with invariant tests, a load test (throughput and p50/p95/p99 latency) and fault injection (crashed nodes, dropped or delayed messages, partitions, clock skew, full disks), then writing a design doc with the numbers, alternatives, where it breaks, how Redis, Kafka, Cassandra or etcd do it, and an interview-ready summary. Works for rate limiters, job queues with retries and visibility timeouts, consistent hashing, LSM-tree key-value stores, write-ahead logs, Raft leader election, cac

517 stars 39 forksLearning & Education

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add dotslashsimran/simcraft --skill system-design-from-scratch
Manual install
git clone --depth 1 https://github.com/dotslashsimran/simcraft.git /tmp/simcraft
mkdir -p ~/.claude/skills
cp -r /tmp/simcraft/skills/learning/system-design-from-scratch ~/.claude/skills/system-design-from-scratch

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# System design from scratch

A whiteboard design is a guess. This skill turns it into evidence: a small system that actually runs, tests that state what must always be true, a load test that measures it, and faults that try to break it. The design doc at the end only contains claims that something in the folder proved.

The sibling skill `from-scratch` teaches one concept step by step. This skill is for systems with load, failure and trade-offs. Use `from-scratch` first if the user has never seen the core idea.

## Tools in this skill

- `scripts/loadgen.py`: async load generator for a Python function or an HTTP endpoint. Open loop (`--rate`, fixed schedule, latency counted from the scheduled time) or closed loop (`--concurrency`). Reports throughput, outcome counts and p50/p90/p95/p99/p99.9 from HdrHistogram-style buckets, plus the generator's own lag. `--rates 200,400,800` sweeps load to find the knee. Text chart always, PNG with `--plot` if matplotlib is installed.
- `scripts/faultsim.py`: deterministic discrete event simulator for message passing nodes. Delay, drop, duplicate, partition, one-way block, crash and restart (disk survives), clock offset and drift, disk full, a random fault schedule (`random_faults`), and invariants checked after every event. Same seed, same run. `python3 scripts/faultsim.py --demo` shows the basics.
Read the full skill on GitHub

Details

Skill name
system-design-from-scratch
Path
skills/learning/system-design-from-scratch/SKILL.md
License
MIT
Repo updated
9 November 2026

FAQ

What does the System Design From Scratch skill do?

Design a backend or distributed system by building a tiny but real working version of it, proving its properties with invariant tests, a load test (throughput and p50/p95/p99 latency) and fault injection (crashed nodes, dropped or delayed messages, partitions, clock skew, full disks), then writing a design doc with the numbers, alternatives, where it breaks, how Redis, Kafka, Cassandra or etcd do it, and an interview-ready summary. Works for rate limiters, job queues with retries and visibility timeouts, consistent hashing, LSM-tree key-value stores, write-ahead logs, Raft leader election, cac

How do I install the System Design From Scratch skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add dotslashsimran/simcraft --skill system-design-from-scratch. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is System Design From Scratch popular?

It lives in dotslashsimran/simcraft, which has 517 GitHub stars and 39 forks.

Related skills

API Design Review

517

dotslashsimran/simcraft

Review the design of an API surface, meaning an HTTP API (OpenAPI spec or route code), an SDK's public classes and functions, or a CLI. Checks naming and consistency, resource modelling, error design (stable codes, RFC 9457 problem details, request ids), versioning and breaking changes, pagination, filtering, idempotency and retries, rate limits, timeouts, long-running operations, webhooks, auth, partial updates, ID, time and money formats, SDK ergonomics and CLI conventions. Uses scripts to lint OpenAPI files, classify changes between two spec versions as breaking or safe, and dump an SDK's p

Software Development39

Benchmark Honestly

517

dotslashsimran/simcraft

Build benchmarks that survive scrutiny and catch the classic lies (dead code elimination, lazy results, constant folding, warm caches, coordinated omission, averages hiding GC pauses, unequal work, noisy machines). Defines the question first, controls and discloses the environment, uses warmups, interleaved repeats, medians, bootstrap confidence intervals and Mann-Whitney tests, and ends with a one-line verdict that includes the CI. Bundles a command runner, an environment reporter and an open-loop latency tester. Use when the user says "benchmark this", "is this faster", "compare performance"

Software Development39

Bisect Anything

517

dotslashsimran/simcraft

Find the exact commit (or dependency version, config value, or input) that caused a regression by turning it into an automatic pass/fail check and running git bisect run in a separate worktree, then shrink the bad commit to the hunk that matters and explain it. Handles failing tests, changed output, slowdowns, crashes, visual changes, server behaviour, flaky checks, unbuildable commits and merge-heavy history. Use when the user says "what broke this", "find the commit that", "when did this start", "it used to work", "regression", "git bisect", "which version broke it", or "which change made it

Git & Code Review39

Teach Back

517

dotslashsimran/simcraft

Find out what the user actually understands about a topic by having them explain it back (the Feynman technique), then probe the gaps one question at a time and end with a one-page cheat sheet and spaced review questions. Works for anything they are studying or have just read, watched or built: a paper, a course, a codebase, an interview topic, a concept. Use when the user says "quiz me", "test my understanding", "help me study", "I'm preparing for an interview on X", "did I get this right", or "make me a cheat sheet".

Learning & Education39

Lazyweb Search Flows

469

LazywebHQ/lazyweb-skill

Study complete product flows for onboarding, checkout, paywalls, signup, and other multi-step journeys.

Learning & Education36

Rl Execution

564

agiprolabs/claude-trading-skills

Reinforcement learning for trade execution optimization including order splitting, adaptive timing, and impact minimization

Learning & Education113

Browse the most popular Claude skills, all learning & education skills, or write your own with the skills generator.