skills.rest
codewizwit
codewizwitCOMMUNITY
Explore all skills by this author →
GitHub

system-design-review

Reviews system architecture across scalability, reliability, security, and operational dimensions with severity-rated findings.

1|Updated Oct 11, 2025
Search Tags:#architecture#security#scalability#system design#infrastructure#reliability#review
One-click install
npx skills add https://github.com/codewizwit/human-in-the-loop --skill system-design-review-codewizwit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: system-design-review
Source: https://github.com/codewizwit/human-in-the-loop/tree/main/lib/skills/system-design-review
Command: npx skills add https://github.com/codewizwit/human-in-the-loop --skill system-design-review-codewizwit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Evaluating whether a system's architecture can scale, stay reliable, and remain secure requires systematic analysis that teams often skip or perform inconsistently, leading to undetected single points of failure and security gaps. ## Core Features & Use Cases - Seven-Dimension Evaluation: Assesses scalability, reliability, security, maintainability, operational excellence, data management, and integration with severity-rated findings. - Structured Review Report: Produces an executive summary, trade-offs analysis table, risk assessment matrix, and prioritized action items with acceptance criteria. - Focused Deep-Dives: Supports scoped reviews targeting a single component or dimension such as scalability or security compliance. - Use Case: Before a major launch, ask for a full architecture audit to receive a report identifying single points of failure, caching gaps, and prioritized remediation steps referencing specific infrastructure files. ## Quick Start Ask the assistant to review the system architecture and provide recommendations, then choose the review scope and priority dimensions when prompted.

Frequently Asked Questions about system-design-review

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

FAQPage Schema
How do I review system architecture for scalability issues?▼

Request an architecture review with a scalability focus to evaluate horizontal and vertical scaling, performance bottlenecks, caching strategies, and load distribution. The review produces specific improvement recommendations referencing your infrastructure and code patterns.

What does a system architecture audit cover?▼

An architecture audit covers seven dimensions: scalability, reliability, security, maintainability, operational excellence, data management, and integration. Each dimension receives a rating of Strong, Needs Improvement, or Critical Issues with actionable recommendations.

Can I review only one component instead of the full system?▼

Yes, the review supports three scopes: full system architecture, a specific component or service, or a focused dimension such as security or reliability. You select the scope through an interactive prompt at the start.

What files does an architecture review examine?▼

The review examines architecture documentation, ADRs, README files, package.json, infrastructure-as-code files like Terraform and CloudFormation, docker-compose files, service definitions, API contracts, and deployment configurations.

What are the limitations of automated architecture review?▼

The review excludes generated code, vendored dependencies, and third-party configurations from analysis. It provides findings and recommendations but does not implement changes, and it relies on existing documentation and ADRs to understand prior design rationale.

Related Skills

Explore More Software Engineering Skills→
thrawn01thrawn01
11

stories-review

Review user stories against a PRD using a three-pass agent workflow.

Community
Advanced
TehminanazTehminanaz
1

world-expert-standards

Codify engineering standards for governance, reliability, observability, and security.

Community
Advanced
Axolotl-ArmyAxolotl-Army

Code Review

Review TypeScript code for security, performance, and architecture issues.

Official
Advanced
mashharukimashharuki
2

aws-well-architected

Review AWS systems against the Well-Architected Framework's six pillars.

Community
Advanced