clean-code

Apply clean code principles to improve code quality in reviews, refactoring, and architecture.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/BenavidesMichael/portfolio --skill clean-code-benavidesmichael
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/BenavidesMichael/portfolio/tree/main/.claude/skills/clean-code
Command: npx skills add https://github.com/BenavidesMichael/portfolio --skill clean-code-benavidesmichael

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Code quality suffers from duplication, complexity, and unclear responsibilities; this skill provides principles and patterns to produce clean, maintainable, and scalable code.

Core Features & Use Cases

  • SOLID: promote modular, testable components by separating responsibilities.
  • DRY, KISS, YAGNI: minimize duplication and unnecessary complexity across codebases.
  • CoC, Composition over Inheritance, LoD: encourage sensible defaults, focused interfaces, and safe object interactions.
  • Practical guidance with examples to assist code reviews, refactoring, and architectural decisions.

Quick Start

Refactor a given codebase by applying SOLID, DRY, KISS, YAGNI, CoC, and LoD principles to improve readability and maintainability.

Frequently Asked Questions about clean-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I apply SOLID principles to refactor an existing codebase?

To refactor an existing codebase with SOLID principles, separate responsibilities into modular, testable components. Implement SRP, OCP, LSP, ISP, and DIP to improve code readability, maintainability, and scalability across languages.

What is the best way to reduce code duplication and complexity during a code review?

The best way to reduce code duplication and complexity during a code review is applying DRY, KISS, and YAGNI principles. These minimize unnecessary complexity across codebases by encouraging sensible defaults and focused interfaces.

When should I use composition over inheritance in architectural decisions?

Use composition over inheritance in architectural decisions to encourage safe object interactions and focused interfaces. It supports clean code principles like the Law of Demeter (LoD) and Convention over Configuration (CoC) for scalable architecture.

Does this clean code approach work across different programming languages?

Yes, this clean code approach works across different languages. It identifies code review, refactoring, and architecture decisions that follow SOLID, DRY, and KISS principles regardless of the specific programming language syntax.

Why does code quality suffer from unclear responsibilities and how do I fix it?

Code quality suffers from unclear responsibilities due to tangled logic and duplication. Fix it by applying clean code principles like SRP to separate concerns, producing clean, maintainable, and scalable code structures.