system-design

Generate system design artifacts including requirements, components, data flows, and storage strategies.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/hpsgd/claude-marketplace --skill system-design-hpsgd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design
Source: https://github.com/hpsgd/claude-marketplace/tree/main/plugins/engineering/architect/skills/system-design
Command: npx skills add https://github.com/hpsgd/claude-marketplace --skill system-design-hpsgd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams create end-to-end system designs with explicit requirements, boundaries, components, data flows, storage decisions, and risk considerations.

Core Features & Use Cases

  • Structured design process: captures functional and non-functional requirements, boundary definitions, and data flows.
  • Artifact generation: produces component diagrams, sequence diagrams, and storage design docs to guide implementation.
  • Use Case: When planning a new feature, generate a complete system design package including assumptions, risks, and decision records.

Quick Start

Provide system context and goals, and ask the skill to produce a complete system design with requirements, architecture, data flows, and risks.

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 with clear trade-offs?

System architecture design involves capturing requirements, defining component boundaries, mapping data flows, and analyzing storage options to produce end-to-end design artifacts. You get a complete package including diagrams, decision records, and explicit trade-offs to guide implementation.

What is the process for defining system boundaries and interfaces for a new service?

Defining system boundaries requires extracting requirements and maintaining an assumption ledger to formalize interface targets. This produces component definitions and data flow mappings that establish clear service limits and interaction contracts for new features.

Can I generate component diagrams and storage design docs for project planning?

Yes, you can generate component diagrams, sequence diagrams, and storage design docs by providing system context and goals. These artifacts are produced as part of a complete system design package that includes assumptions, risks, and decision records to guide project planning.

How do I document assumptions and risk management decisions during system design?

You document assumptions and risks by maintaining an assumption ledger and performing options analysis during the design process. This captures non-functional targets and trade-offs, resulting in formal decision records for risk management.

What's the best way to analyze trade-offs for non-functional requirements in software architecture?

The best way to analyze trade-offs is through formal options analysis that evaluates storage strategies and component designs against non-functional targets. This yields explicit risk considerations and decision records that justify architectural choices.

When do I need a formal system design process with data flow mapping?

You need a formal system design process with data flow mapping when planning new features or services that require robust scalability. It ensures teams capture functional boundaries, storage decisions, and risk considerations before implementation begins.