CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

system-design

Design scalable distributed systems using structured approaches for load balancing, caching, database scaling, and message queues. Use when the user mentions "system design", "scale this", "high availability", "rate limiter", "design a URL shortener", "system design interview", "capacity planning", or "distributed architecture". Also trigger when estimating infrastructure requirements, choosing between microservices and monoliths, or designing for millions of concurrent users. Covers common system designs and back-of-the-envelope estimation. For data fundamentals, see ddia-systems. For resilience, see release-it.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured framework skill: the four-step process, estimation formulas, and diagnostic checklists are actionable, and progressive disclosure is genuinely good with six real, one-level-deep reference files. Its main weakness is token efficiency -- a large share of the body restates standard distributed-systems knowledge Claude already has, plus padding (author bio, why-it-works paragraphs, affiliate links) that competes with conversation context.

Suggestions

Remove the 'About the Author' section and trim 'Further Reading' (affiliate-tagged book links) -- they add tokens with no operational value for executing the skill.

Cut the 'Why it works' paragraphs and entry-level definitions Claude already knows (DNS/CDN, load balancer layers, SQL vs NoSQL basics), keeping only the non-obvious content: estimation formulas, decision tables, and the diagnostic checklists.

Deduplicate the body against the reference files -- e.g., powers of two and latency numbers appear both in SKILL.md and references/estimation-numbers.md; keep one-line summaries in the body and let the references carry the detail.

DimensionReasoningScore

Conciseness

Mostly efficient -- tables, formulas, and checklists are dense with real information -- but it includes several padded sections Claude does not need: six 'Why it works' paragraphs, an 'About the Author' biography, affiliate-tagged 'Further Reading' links, and basic definitions Claude already knows ('DNS resolves domain names; CDN caches static assets', SQL-vs-NoSQL basics). It sits between the 2 anchor (several unnecessary explanations) and the 3 anchor; the consistently tight tabular format keeps it at 3 rather than dropping to 2.

3 / 5

Actionability

Provides concrete, executable guidance: worked formulas ('100M DAU x 5 actions / 86400 = ~5,800 QPS avg, ~30K QPS peak', '500M tweets/day x 300 bytes x 365 days = ~55 TB/year') and specific patterns with parameters ('100 tokens/min per API key; refill at steady rate; reject with 429'). As an instruction-only skill, absent code is not penalized, but some guidance remains at the pattern level ('draw a high-level diagram with APIs, services, data stores') rather than being fully concrete, keeping it below the 5 anchor.

4 / 5

Workflow Clarity

The four-step process is clearly sequenced with time allocations and explicit checkpoints ('Never skip Step 1', 'Get explicit agreement on assumptions before proceeding'), and the Quick Diagnostic table acts as a checklist. It falls short of the 5 anchor because there is no explicit error-recovery or feedback loop (no revise-and-recheck cycle after a design review or estimate fails sanity checks).

4 / 5

Progressive Disclosure

All six referenced files exist, are one level deep (verified: reference files contain only internal anchors, no nested references), and are clearly signaled both per-section ('See: [references/...]') and in a consolidated Reference Files index with one-line descriptions. It misses the 5 anchor because the body duplicates a notable amount of reference content (powers of two, latency numbers, and cache strategies appear both inline and in the reference files), so SKILL.md is longer than a lean overview.

4 / 5

Total

15

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, specific about capabilities, with an explicit and comprehensive 'Use when...' trigger list covering natural user phrasings. The explicit pointers to sibling skills (ddia-systems, release-it) further reduce mis-trigger risk; the only weakness is that a few capability areas covered in the body are not reflected in the description.

DimensionReasoningScore

Specificity

Names the domain and several concrete action areas -- 'load balancing, caching, database scaling, and message queues' plus 'back-of-the-envelope estimation' -- but coverage has minor gaps (reliability/operations and monitoring are not named as capabilities). It lists several specific actions rather than only 1-2, placing it above the 3 anchor but short of the comprehensive coverage of the 5 anchor.

4 / 5

Completeness

Explicitly answers 'what' ('Design scalable distributed systems using structured approaches for...') and 'when' with concrete trigger phrases ('Use when the user mentions...' followed by 8 phrases, then 'Also trigger when...'). This matches the anchor for clearly and explicitly answering both what AND when with concrete triggers.

5 / 5

Trigger Term Quality

Eight quoted natural trigger phrases ('system design', 'scale this', 'high availability', 'rate limiter', 'design a URL shortener', 'system design interview', 'capacity planning', 'distributed architecture') plus three additional trigger conditions ('estimating infrastructure requirements', 'choosing between microservices and monoliths', 'designing for millions of concurrent users'). Coverage is comprehensive across synonyms and phrasings a user would naturally say; no common variation is obviously missing.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (distributed system design) with domain-specific triggers, and explicitly disambiguates sibling skills ('For data fundamentals, see ddia-systems. For resilience, see release-it.'), minimizing conflict risk. Uses third-person voice throughout, so no voice penalty applies.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

valeriibeck-star/claude-skills

Path

skills/system-design/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.