How does it reduce code complexity?

It applies a verification checklist that flags any function with a cognitive complexity score over 15 or nesting deeper than three levels.

Which programming languages benefit most from this skill?

While the principles are universal, it is optimized for typed languages like Swift, Kotlin, TypeScript, and Java where type safety and interfaces are paramount.

How does this skill help with SOLID principles?

The skill uses a Design Analysis phase to verify a single responsibility for every component and ensures implementations follow dependency injection and interface-driven design.

Can I use this for existing legacy code?

Yes, it is specifically designed to handle refactoring tasks, helping you split large, complex classes into smaller, decoupled modules.

Clean Code Architect

Name: Clean Code Architect
Author: bitsydarel

bybitsydarel

0•

Developer Tools

Enforces SOLID principles and architectural best practices to generate, refactor, and review high-quality, type-safe code.

The bd-clean-code-writing skill transforms Claude into a rigorous code architect focused on long-term maintainability and structural integrity. By implementing a multi-step workflow—ranging from initial design analysis to strict verification checklists—it ensures that every piece of code adheres to SOLID principles, maintains low cognitive complexity, and follows layered architecture patterns. Whether you are building new components from scratch or refactoring legacy systems, this skill helps prevent technical debt by enforcing separation of concerns, explicit type safety, and clean abstraction layers across various programming languages.

Key Features

01Complexity Management: Enforces limits on cognitive complexity and nesting depth to ensure high readability.

02Architectural Layering: Guides the strict separation of Presentation, Domain, and Data layers for modularity.

03Type Safety Guardrails: Eliminates 'Any' or 'dynamic' types while requiring explicit nullability and constant extraction.

04SOLID Principle Enforcement: Automatically applies core design principles to all generated and refactored code.

05Structured Refactoring: Provides a proven workflow for splitting large classes and modernizing legacy logic.

060 GitHub stars

Use Cases

01Refactoring monolithic legacy classes into smaller, testable, and maintainable units.

02Designing new modular service architectures with strict dependency injection patterns.

03Performing automated architectural reviews to identify and fix code smells or SOLID violations.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bitsydarel/bdskills bd-clean-code-writing

For use in Claude.ai and ChatGPT

Download Skill