How does this skill help with SOLID principles?

It identifies specific violations such as 'god classes' or tight coupling and suggests refactoring strategies to align with Single Responsibility and Open/Closed principles.

What does the skill check during a design review?

It assesses naming consistency, abstraction leakage, interface segregation, and whether objects own their state transitions versus external orchestration.

Can it help me choose between REST and GraphQL?

Yes, it evaluates your specific project requirements, query complexity, and client needs to recommend the most suitable API protocol.

How does it improve Developer Experience (DX)?

The skill analyzes error message clarity, onboarding ease, and whether your code conventions are consistent with the broader ecosystem.

Code Design & Architecture Review

Name: Code Design & Architecture Review
Author: yzavyas

byyzavyas

•

API Development

Evaluates code architecture, API contracts, and SOLID compliance to ensure maintainable and scalable software systems.

This skill empowers Claude to perform deep architectural audits of your codebase, focusing on abstraction quality, naming consistency, and adherence to SOLID principles. It provides actionable feedback on API design choices—including protocol selection between REST, GraphQL, and gRPC—while highlighting developer experience (DX) friction points. By analyzing patterns like 'Tell, Don't Ask' and identifying leaky abstractions, it helps developers prevent technical debt and ensure their system architecture remains robust as it scales.

Key Features

01Structured design review reports with prioritized actionable recommendations

02API design evaluation across REST, GraphQL, and gRPC protocols

03Developer Experience (DX) analysis for onboarding and documentation clarity

043 GitHub stars

05Comprehensive SOLID compliance audits and violation detection

06Abstraction quality assessment including naming and intent-revealing patterns

Use Cases

01Refactoring complex 'god classes' into decoupled, SOLID-compliant structures

02Reviewing a new microservice API contract for consistency and scalability

03Evaluating and improving the developer experience of a library or internal framework

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yzavyas/claude-1337 design

For use in Claude.ai and ChatGPT

Download Skill