System Design & Architecture

VerifiedSafe

Guides the agent in analyzing, recommending, and documenting software system architecture and trade-offs. Use this skill for high-level design tasks such as component breakdowns, performance constraints, and architectural patterns.

Sby Skills Guide Bot
DevelopmentIntermediate
606/2/2026
Claude Code
#system-design#architecture#scalability#trade-offs#patterns

Recommended for

Our review

Guides the agent in analyzing, recommending, and documenting software system architecture and trade-offs.

Strengths

  • Provides a structured method to break down system components.
  • Makes trade-offs explicit between performance, scalability, reliability, and security.
  • Recommends architectural patterns that fit the context.

Limitations

  • Requires clear performance constraints to be effective.
  • May produce complex diagrams for very large systems.
  • Does not replace validation through prototyping or load testing.
When to use it

Use this skill when you need to design a system architecture or evaluate trade-offs between non-functional qualities.

When not to use it

Avoid this skill for purely algorithmic or low-level tasks (e.g., optimizing a single function).

Security analysis

Safe
Quality score90/100

This skill only provides textual guidance on system design analysis and documentation. It uses only Read and Write tools, and does not instruct or imply any code execution, system modification, or dangerous operations.

No concerns found

Examples

Scalable document search system
Design a scalable document search system for 10M users with sub-second queries and secure access controls.
Trade-off analysis for e-commerce platform
Evaluate architectural trade-offs for an e-commerce platform handling flash sales, considering cost, performance, and consistency.

name: system-design description: Guides the agent in analyzing, recommending, and documenting software system architecture and trade-offs. Use this skill for high-level design tasks such as component breakdowns, performance constraints, and architectural patterns. license: Apache-2.0 metadata: category: engineering version: "1.0" allowed-tools: Read Write

System Design Skill

Overview

This skill enables the agent to perform robust system design reasoning with explicit attention to quality attributes: performance, scalability, reliability, and security.

When to use

Activate this skill when the task involves:

  • Designing a system architecture
  • Evaluating design trade-offs (performance vs cost vs complexity)
  • Recommending architectural patterns
  • Identifying non-functional requirements

Instructions

  1. Start by identifying the contextual constraints (scale, latency, consistency, security requirements).
  2. Enumerate system components and interactions.
  3. For each major quality attribute (performance, reliability, security), provide explicit reasoning on trade-offs.
  4. Recommend patterns (e.g., microservices, event-driven, caching strategies) and justify selection.
  5. Produce a structured design document (sections: Overview, Requirements, Components, Quality Attribute Analysis, Diagrams/References).

Examples

Input: “Design a scalable document search system for 10M users with sub-second queries and secure access controls.”
Output:

  • Requirements breakdown
  • Quality attribute analysis
  • Suggested architecture pattern
  • Estimated throughput/latency

Edge Cases

  • Conflicting non-functional requirements
  • Undefined performance constraints
Related skills