system-design

Design systems and evaluate architectural decisions for scalable solutions.

704|58|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/openyak/desktop --skill system-design-openyak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design
Source: https://github.com/openyak/desktop/tree/main/backend/app/data/plugins/engineering/skills/system-design
Command: npx skills add https://github.com/openyak/desktop --skill system-design-openyak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design systems and evaluate architectural decisions to help teams build scalable, maintainable software.

Core Features & Use Cases

  • Framework for Requirements Gathering, High-Level Design, Deep Dive, Scale & Reliability, and Trade-off Analysis.
  • Use cases include API design, data modeling, service boundaries, and documentation of architectural decisions.
  • Example: design a microservice-based platform with clear data flows, interfaces, and resilience strategies.

Quick Start

Draft a complete system design for a given requirement and iteratively refine architecture decisions.

Frequently Asked Questions about system-design

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

FAQPage Schema
How do I design a scalable system architecture from scratch?

To design a scalable system architecture, you need a structured process covering requirements gathering, high-level design, deep-dive analysis, scalability planning, and explicit trade-off evaluation to ensure maintainable software.

What is the best way to evaluate architectural trade-offs for a microservice platform?

Evaluating architectural trade-offs involves analyzing service boundaries, data flows, interfaces, and resilience strategies to inform scalable solutions and document decisions for a microservice-based platform.

How does data modeling fit into the system design process?

Data modeling is a core use case within system design that defines service boundaries and data flows, ensuring the architecture satisfies structural design requirements and scales effectively under load.

Can I use this approach for API design and defining service boundaries?

Yes, this approach is applicable across API design, data modeling, and defining service boundaries, providing a framework to evaluate architectural decisions in varied project contexts.

What steps are needed to document architectural decisions for infrastructure?

Documenting architectural decisions requires gathering requirements, drafting a high-level design, conducting a deep dive, planning for scale and reliability, and explicitly evaluating trade-offs to inform infrastructure choices.

When should I not use a microservice architecture for my system design?

You should evaluate microservice architecture trade-offs during the design process; if explicit trade-off evaluation reveals unacceptable complexity for your infrastructure context, alternative service boundaries should be considered.