system-design-doc

Create system design documents with architecture diagrams, capacity estimates, and scaling strategies.

1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/kalilurrahman/kr-claudiator-skills-original-prompts --skill system-design-doc-kalilurrahman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design-doc
Source: https://github.com/kalilurrahman/kr-claudiator-skills-original-prompts/tree/main/06-system-design/system-design-doc
Command: npx skills add https://github.com/kalilurrahman/kr-claudiator-skills-original-prompts --skill system-design-doc-kalilurrahman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing system design documentation often produces vague diagrams and hand-wavy claims like "high traffic" instead of concrete numbers, making it hard for engineers and stakeholders to evaluate or implement an architecture. This Skill enforces a rigorous structure with quantified requirements, capacity estimation, and documented trade-offs. ## Core Features & Use Cases - Structured Design Process: Walks through requirements definition, scale estimation, high-level design, component detailing, scaling plans, failure analysis, and decision documentation. - Concrete Output Template: Produces documents with ASCII architecture diagrams, API contracts with real request/response JSON, database schemas, cache strategies, and cost estimates. - Complete Worked Example: Includes a full URL shortener design covering PostgreSQL schema, Redis caching, base62 ID generation, failure scenarios, monitoring alerts, and AWS cost breakdown. - Use Case: When planning a new service handling 1B requests per month, use this Skill to produce a design doc with capacity math, component specs, failover plans, and a deployment timeline that your team can review and execute against. ## Quick Start Use the system-design-doc skill to create a design document for a notification service handling 10 million users with p99 latency under 200ms.

Frequently Asked Questions about system-design-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a system design document for a new service?

Start by defining functional and non-functional requirements with concrete numbers, then estimate capacity for storage, traffic, and bandwidth. Detail each component with its tech stack and API contracts, plan for scaling bottlenecks, and document failure scenarios with recovery times.

What should a system design document include?

A complete design doc includes quantified requirements, capacity estimation, a high-level architecture diagram with data flow arrows, component details with specific technologies, API contracts with real JSON, scaling strategies, failure scenarios, monitoring alerts, and cost estimates.

How do I estimate capacity for a system design?

Calculate storage by multiplying records per period by record size and projecting over years. Estimate traffic by dividing monthly requests by seconds per month to get requests per second, then derive bandwidth from request size multiplied by request rate.

Should I use SQL or NoSQL in my system design?

The choice depends on scale, query patterns, and cost. The example design rejected DynamoDB in favor of PostgreSQL because the workload was predictable and relational, but documents this trade-off explicitly so reviewers understand the reasoning.

How do I document failure scenarios in architecture docs?

List each single point of failure, describe its impact, state the mitigation such as auto-failover or graceful degradation, and specify expected recovery time. Vague statements like "failover happens" are insufficient without concrete recovery targets.