Skip to main content
Designmelodic-software

explain

Explain a systems design concept

Stars
74
Source
melodic-software/claude-code-plugins
Updated
2026-04-07
Slug
melodic-software--claude-code-plugins--explain
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/melodic-software/claude-code-plugins/HEAD/plugins/systems-design/skills/explain/SKILL.md -o .claude/skills/explain.md

Drops the SKILL.md into .claude/skills/explain.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Explain Systems Design Concept

Explain a systems design concept in practical, developer-friendly terms.

Arguments

$ARGUMENTS - The concept to explain (e.g., "CAP theorem", "sharding", "circuit breaker", "load balancing")

Workflow

  1. Identify the concept category to load the appropriate skill:

    • Interview methodology → design-interview-methodology
    • Estimation/capacity → estimation-techniques
    • Quality attributes/NFRs → quality-attributes-taxonomy
    • Future phases: distributed systems, scalability, cloud-native
  2. Provide a practical explanation that:

    • Explains what it is in plain terms
    • Shows why it matters for system design
    • Gives concrete examples when possible
    • Discusses trade-offs and when to use it
    • Links to related concepts
  3. Include reference examples where helpful:

    • Back-of-envelope calculations for scale concepts
    • Decision criteria for pattern selection
    • Real-world analogies for complex concepts

Example Usage

/sd:explain CAP theorem
/sd:explain sharding
/sd:explain circuit breaker
/sd:explain back-of-envelope
/sd:explain load balancing
/sd:explain eventual consistency
/sd:explain latency vs throughput
/sd:explain quality attributes
/sd:explain scalability
/sd:explain the "-ilities"

Concept Categories

Currently Available (Phase 1)

Category Example Concepts
Interview methodology 4-step framework, requirements gathering, deep dives
Estimation QPS, storage, bandwidth, latency numbers
Quality attributes Scalability, reliability, availability, performance, security

Coming in Future Phases

Category Example Concepts
Distributed systems CAP theorem, consensus, message queues
Scalability Load balancing, sharding, caching
Cloud-native Kubernetes, serverless, service mesh

Output

A clear, practical explanation that helps engineers understand and apply the concept in real system designs.