Can I run checks for just one specific principle like DRY or KISS?

Yes, you can use specific subcommands like sw-dry or sw-kiss to focus your analysis on a single architectural concern.

Does this skill support microservices or only monoliths?

It supports both. It adapts its analysis based on the system scale, focusing on internal layering for monoliths and data ownership/messaging for distributed systems.

Can the skill help me fix the issues it finds?

Yes, it includes an optional Refactor Mode that provides code suggestions or architecture proposals to resolve identified violations.

How does Beyond SOLID differ from standard SOLID checks?

Standard SOLID focuses on class-level object-oriented design, while Beyond SOLID evaluates system-level architecture, including service boundaries, API contracts, and resilience patterns.

How are the findings presented?

Findings include a severity rating (High, Medium, or Low), the specific location of the issue, a clear explanation of the violation, and concrete suggestions for remediation.

Beyond SOLID Principles

Name: Beyond SOLID Principles
Author: florianbuetow

byflorianbuetow

•

API Development

Audits software architecture and system design against ten foundational principles to identify structural smells and improve evolvability.

Beyond SOLID is a comprehensive architectural analysis tool for Claude Code that evaluates source code, module boundaries, and service interactions. It moves beyond class-level design to assess system-wide health using ten critical principles including Separation of Concerns, Resilience, and Loose Coupling. Whether you are managing a monolith or a microservices mesh, this skill provides actionable remediation strategies and severity ratings to help teams maintain a clean, scalable, and maintainable codebase. It is designed to adapt its rigor based on project scale, ensuring that architectural suggestions remain pragmatic and valuable.

Key Features

01Comprehensive system-level audits covering ten foundational architectural principles.

024 GitHub stars

03Context-aware analysis for different scales, from small prototypes to distributed systems.

04Interactive refactoring mode to automatically generate improved code and architecture patterns.

05Granular subcommands for targeted checks like Resilience, KISS, and YAGNI.

06Prioritized reporting with severity levels (High/Medium/Low) and actionable remediation steps.

Use Cases

01Identifying and fixing architecture smells and technical debt in legacy monolithic systems.

02Evaluating the resilience and coupling of microservices and distributed API contracts.

03Performing automated architectural reviews during the CI/CD process or manual code review phase.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add florianbuetow/claude-code beyond-solid-principles

For use in Claude.ai and ChatGPT

Download Skill