Skip to content

git-akki/system-design-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 System Design Skill for Claude Code

A skill for Claude Code that turns Claude into an expert system design coach — for interview prep, real-world architecture, and distributed systems concepts.

Synthesized from a 7-hour Scaler Academy system design course and best practices from engineers at Facebook, Uber, Twitter, and Google scale.


What It Does

Trigger What happens
"design Uber" / "design Twitter" Walks through full HLD using the 5-step framework
"explain consistent hashing" Analogy-first explanation → technical definition → real usage
"mock system design interview" Simulates interviewer, gives feedback, flags red flags
"LLD for Tic-Tac-Toe" Class design, patterns, code, test cases
"what is CAP theorem" Deep concept explanation with trade-off guide

Topics Covered

  • 5-Step Interview Framework — requirements → estimation → design goals → single-server design → scale
  • Relational Data Modeling — entities, relationships, junction tables, schema anti-patterns
  • Scaling — vertical vs horizontal, DNS, geo-routing
  • Load Balancing — L4 vs L7, 6 routing algorithms, SPOF elimination
  • Stateless vs Stateful — when to use each, trade-offs
  • Consistent Hashing — ring, virtual nodes, redistribution math
  • Caching — write-through, cache-aside, invalidation, Redis
  • CAP Theorem + PACELC — with per-system trade-off decisions
  • Database Selection Guide — Redis, Cassandra, PostgreSQL, S3, Elasticsearch, Kafka, Geospatial
  • Case Studies — URL Shortener, Typeahead, Tinder, Uber, Twitter
  • Low-Level Design (LLD) — Builder pattern, separation of concerns, testing
  • Batch vs Stream Processing — when to use each, tooling
  • Key Formulas — storage, QPS, Base-62 space, redistribution
  • 17 Common Interview Red Flags — what interviewers penalize

Install

Option 1 — Copy directly (recommended)

# Clone the repo
git clone https://github.com/git-akki/system-design-skill.git

# Install the skill
cp -r system-design-skill/skill ~/.claude/skills/system-design

Then restart Claude Code. The skill auto-activates.

Option 2 — Manual

  1. Download or clone this repo
  2. Copy the skill/ folder to ~/.claude/skills/system-design/
  3. Restart Claude Code

File Structure

skill/
├── SKILL.md                    ← Skill entry point (trigger + instructions)
└── references/
    └── knowledge-base.md       ← Full knowledge base (loaded on demand)

The skill uses progressive disclosureSKILL.md is lean (~50 lines) and loads references/knowledge-base.md only when triggered. This keeps context efficient.


Usage Examples

Once installed, just talk naturally to Claude:

design a URL shortener for 1M daily users
explain consistent hashing with an example
mock system design interview — I'll design Twitter
what database should I use for a real-time leaderboard?
review my design — am I missing anything?
low-level design of a parking lot system

Knowledge Source

Built from:


Contributing

PRs welcome! If you have:

  • New case studies (YouTube, Instagram, WhatsApp, etc.)
  • Better analogies for concepts
  • Additional red flags or formulas

Open a PR against skill/references/knowledge-base.md.


License

MIT — free to use, modify, and distribute.

About

A Claude Code skill that turns Claude into an expert system design coach — for interview prep, HLD/LLD, and distributed systems concepts.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors