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.

About

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

Structured design review reports with prioritized actionable recommendations
API design evaluation across REST, GraphQL, and gRPC protocols
Developer Experience (DX) analysis for onboarding and documentation clarity
3 GitHub stars
Comprehensive SOLID compliance audits and violation detection
Abstraction quality assessment including naming and intent-revealing patterns

Use Cases

Refactoring complex 'god classes' into decoupled, SOLID-compliant structures
Reviewing a new microservice API contract for consistency and scalability
Evaluating and improving the developer experience of a library or internal framework

About

Key Features

Structured design review reports with prioritized actionable recommendations
API design evaluation across REST, GraphQL, and gRPC protocols
Developer Experience (DX) analysis for onboarding and documentation clarity
3 GitHub stars
Comprehensive SOLID compliance audits and violation detection
Abstraction quality assessment including naming and intent-revealing patterns

Use Cases

Refactoring complex 'god classes' into decoupled, SOLID-compliant structures
Reviewing a new microservice API contract for consistency and scalability
Evaluating and improving the developer experience of a library or internal framework