--- title: "System design practice reviewer" type: "skill" url: "https://useaiblocks.com/skills/system-design-practice-review" updated: "2026-10-28" first_published: "2026-10-25" job: "Study and check your understanding" tested: true licence: "MIT" source: "https://github.com/yugash007/edu-agent-skills/tree/e75f44303570bb2eae37a8f7536c0358be2502ee/skills/projects/architecture-review" instructions: "https://useaiblocks.com/skills/system-design-practice-review/SKILL.md" --- # System design practice reviewer > Get a system design review that asks first, then ranks risks and gives a revision checklist. Share your design and see where it may break. Share your design, expected load and learning goal. It names what works, then asks questions that test your assumptions. You compare options for the biggest risks and get a checklist of the changes you choose to make. Free skill for the job "Study and check your understanding" · Level: beginner · Thinking: medium · Safety checked · Updated 2026-10-28 ## Links - Page: https://useaiblocks.com/skills/system-design-practice-review - Instructions (SKILL.md): https://useaiblocks.com/skills/system-design-practice-review/SKILL.md - All files (zip): https://useaiblocks.com/skills/system-design-practice-review.zip - JSON version: https://useaiblocks.com/skills/system-design-practice-review.json - In your AI: connect https://useaiblocks.com/mcp and ask "Use AI Blocks to get system-design-practice-review" ## What it does Share your design, expected load and learning goal. It names what works, then asks questions that test your assumptions. You compare options for the biggest risks and get a checklist of the changes you choose to make. ## What you give it - A system design as a diagram, description or code. - Expected load, reliability needs, team limits and learning goal. ## What you get - A question-led review of your design. - Ranked risks and alternatives with tradeoffs. - A revision checklist based on your choices. ## Example: what goes in and what comes out ### What goes in - Your system design as a diagram, a written description or code - Expected load, reliability needs and team limits - Your learning goal (optional) ### What comes out - **Design summary**: A short restatement of your design so you and your AI agree on what is being reviewed. - **Strengths**: Two or three things your design does well, stated before any criticism. - **Probe questions**: Two or three questions that test your weakest assumptions, asked before any issues are shown. - **Issues**: Problems ordered from critical to minor, each with its area and how serious it is. - **Alternatives**: Two options for each critical or major issue, with the tradeoffs of each. - **Choice prompt**: A question asking you to pick an option and give your reason. - **Revision checklist**: Short, concrete next steps based on the changes you chose. ## Skip it when - You have no design yet: use the Build with me skill to shape one first, then come back for the review. - You do not know a core idea in your design, such as caching or queues: ask your AI to teach that idea first. - Your design is a simple script with no real choices to weigh: a quick read from a teammate is enough. ## How to use it 1. Open Claude, ChatGPT or Gemini and paste the skill instructions into a new chat. 2. Paste your design, or describe it. Add your expected load, uptime needs and team limits. 3. Answer the probe questions in your own words. The AI waits for your reasoning before it lists issues. 4. Pick an option for each major issue and say why. 5. Use the final checklist to revise your design yourself. This skill needs no code running, files or paid tools. ## What to do next - [Study practice progress reviewer](https://useaiblocks.com/skills/study-plan-progress-review-assistant): Study practice progress reviewer ## Sources and credits - From edu-agent-skills contributors: https://github.com/yugash007/edu-agent-skills/tree/e75f44303570bb2eae37a8f7536c0358be2502ee/skills/projects/architecture-review, shared under the MIT licence (original name: architecture-review). - [architecture-review skill](https://github.com/yugash007/edu-agent-skills/tree/e75f44303570bb2eae37a8f7536c0358be2502ee/skills/projects/architecture-review), edu-agent-skills contributors: Copied under the MIT licence. We gave it a plain name. We added Before you start and After this sections that link to other AI Blocks steps. ## Instructions (SKILL.md) ## Purpose Evaluate a system design through structured probing that surfaces the learner's reasoning before prescribing corrections. Review across five dimensions: correctness, scalability, reliability, maintainability, observability. ## Activation - Learner proposes a design or architecture. `build-with-me` reaches architecture phase. Learner asks "is this design good?" Interview prep on system design. Pre-deployment review. - **Skip if**: no design exists yet → use `teach-concept` or `build-with-me` to help create one. Design is a simple script with no architectural decisions. - **Routing**: if foundational concept gap blocks review → pause and route to `teach-concept` first. After review, hand off to `build-with-me` for implementation or `challenge-generator` for design alternatives. ## Inputs - Design proposal (diagram, description, or code), system constraints (scale, latency, team), learner level and goals. ## Review Dimensions - **Correctness**: does it solve the stated problem? Data integrity? Security? - **Scalability**: bottlenecks at 10×, 100× current load? - **Reliability**: single points of failure? Failure recovery? Data loss risk? - **Maintainability**: complexity growth? Team onboarding? Testing surface? - **Observability**: monitoring, alerting, debugging at runtime? ## Workflow 1. **Strengths** — Identify and state 2–3 things the design does well. Never start with criticism. 2. **Probe** — 2–3 targeted questions exposing untested assumptions. Focus on the dimension where the design is weakest. Require learner reasoning before revealing issues. 3. **Issues** — After learner responds: list issues priority-ordered by severity (Critical → Major → Minor). Each issue: dimension, description, severity. 4. **Alternatives** — For each Critical/Major issue: propose 2 options with tradeoffs. Ask learner to choose with rationale. 5. **Revision** — Summarize the agreed changes. Provide a short checklist of concrete next steps. ## Rules - DO: probe before prescribing — require learner reasoning first. - DO: strengths first — never open with criticism. - DO: alternatives with tradeoffs, not single "correct" answers. - DO: pause review and route to `teach-concept` if a foundational concept gap blocks understanding. - DON'T: rewrite the design for the learner — coach them to revise it. - DON'T: skip Critical issues to keep the session positive. - DON'T: grade every dimension equally — focus on the weakest 2–3. - DON'T: continue review when a fundamental security or correctness flaw needs conceptual teaching first. ## Output Responses should contain: design summary, strengths (2–3), probe questions, issues (priority-ordered with dimension + severity), alternatives with tradeoffs, learner choice prompt, and revision checklist. Format naturally. ## Checklist - [ ] Strengths stated before any criticism. - [ ] Probe questions asked before issues revealed. - [ ] Issues priority-ordered with severity. - [ ] Alternatives provided for Critical/Major issues with tradeoffs. ### Before you start Use the material below to do this job. If facts or tool access are missing, explain what you can finish and what must wait. **What you need** (use your own material or the linked skill): - **A document** (yours): a finished document, such as a Word file, a PDF or a page of notes. **Makes it better (optional):** - **A codebase** (yours): a project's code, in a folder or repo the AI can open. How to start: 1. **Look first.** Use what they've already attached, pasted or put in their about-me note. In a coding assistant with file access, look in the project too for these by name. 2. **Check what's missing.** Look for a document, a codebase. They can attach files, paste the details, or share a file path your assistant can read. Ask only for missing facts that change the result. If they ask you to start with what they have, complete the parts you can and mark the gaps. 3. **Do the job.** Follow the skill below with the facts and tools you have. Mark each gap with `MISSING:` where it belongs and never invent a fact to fill it. ### After this When you've handed it back, suggest what they could do next in one short question. It's a suggestion: if they're done, that's fine. Offer these, and say they can type their own: - The [Study practice progress reviewer](https://useaiblocks.com/skills/study-plan-progress-review-assistant). It takes the notes. If they pick one and that skill is added here, carry straight on with what you just made. If not, give the link and say what to bring.