Software Design Review
Critically review a software design specification and suggest concrete improvements.
Install
npx skills add stencila/stencila --skill software-design-review -g -a claude-code -y- Repository
- stencila/stencila914
- Category
- Design
- Updated
- 3d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 2,475 tokens
- Runs scripts
- No, instructions only
What it does
Critically review a software design specification and suggest concrete improvements. Use when the user wants to review, critique, audit, evaluate, or strengthen a design spec, technical specification, feature design, architecture proposal, or implementation plan. Focus on clarity, completeness, correctness, feasibility, tradeoffs, risks, assumptions, and actionable recommendations that improve the design without turning the task into code generation or workflow design.
Overview
Review an existing software design specification with the goal of making it clearer, more complete, more correct, and more useful for implementation and decision-making. The skill should produce a structured critique that identifies strengths, weaknesses, risks, open questions, and concrete improvements. Prefer critique plus revision guidance over rewriting the full specification unless the user explicitly asks for a rewritten version.
Use this skill when the user already has a design artifact and wants critical review rather than initial drafting. It complements software-design-creation by evaluating a spec after it has been written. Do not use it when the main task is to write production code, review source code, or create workflows or agents.
