How proyecto26/system-design-skills works
system-design-skills is a Claude Code plugin and portable skill catalog for reasoning through system designs. The main workflow starts with a design prompt, enters the /design command or conversational orchestrator, clarifies requirements, estimates scale, composes relevant building blocks, evaluates trade-offs and failure modes, and iterates before rendering and scoring a design document. Users can also invoke individual blocks directly. The README documents these relationships; sampled site files implement an onboarding presentation, not the design workflow itself, so the graph does not infer runtime calls between skill files.
Main entry points: design.md /design command · system-design/SKILL.md System-design skill · back-of-the-envelope/SKILL.md Back-of-envelope · architecture-diagram/SKILL.md Architecture diagram
Components 19
Entry points
- /design command
commands/design.md - Orchestrator agent
agents/system-design-orchestrator.md - System-design skill
skills/system-design/SKILL.md
Design method
- Requirements scoping
skills/requirements-scoping/SKILL.md - Back-of-envelope
skills/back-of-the-envelope/SKILL.md - Sizing calculator
skills/back-of-the-envelope/scripts/botec.py - Design and iteration
skills/system-design/SKILL.md
Building blocks
- Edge blocks
skills - Service blocks
skills - State blocks
skills - Async blocks
skills - Correctness block
skills/consistency-coordination/SKILL.md - Operations blocks
skills - Growth block
skills/scaling-evolution/SKILL.md
Design outputs
- Architecture diagram
skills/architecture-diagram/SKILL.md - Scored design document
- Onboarding presentation
site/src/App.jsx - Presentation diagrams
site/src/diagrams.jsx
Other components
- Designer
Connections 17
- Designer → /design command: starts design
README.md - Designer → System-design skill: asks conversationally
README.md - Designer → Edge blocks: asks one question
README.md - /design command → Orchestrator agent: dispatches optionally
README.md - /design command → Requirements scoping: runs workflow
README.md - /design command → Back-of-envelope: runs workflow
README.md - /design command → Edge blocks: invokes blocks
README.md - /design command → Architecture diagram: renders design
README.md - /design command → Scored design document: scores and persists
README.md - System-design skill → Requirements scoping: clarifies scope
README.md - System-design skill → Back-of-envelope: sizes design
README.md - System-design skill → Edge blocks: routes to blocks
README.md - System-design skill → Design and iteration: iterates trade-offs
README.md - Back-of-envelope → Sizing calculator: can calculate
README.md - Design and iteration → Architecture diagram: renders architecture
README.md - Architecture diagram → Scored design document: produces diagram
README.md - Onboarding presentation → Presentation diagrams: renders diagrams
site/src/App.jsx