Does it remove all code comments?

It removes redundant comments that explain 'what' the code does and replaces them with self-documenting code, while keeping or adding 'why' comments for business logic.

What triggers the Clean Code skill?

The skill is triggered when Claude identifies functions over 20 lines, unclear naming (like 'data' or 'temp'), nested conditions, or generic error handling.

Can it help with SOLID principles?

Yes, it provides specific implementation patterns and refactoring logic for all five SOLID principles to ensure your architecture is robust and extensible.

How does it improve error handling?

It identifies and replaces generic catch-all blocks and swallowed errors with specific, deliberate handling and proper context propagation.

Clean Code Principles

Name: Clean Code Principles
Author: markky21

bymarkky21

0•

Developer Tools

Refactors and reviews code to improve readability, maintainability, and adherence to SOLID principles and industry-standard naming conventions.

This skill empowers Claude to act as a rigorous code reviewer and refactoring specialist. It provides domain-specific guidance on reducing cognitive load by identifying common code smells like 'God Classes,' deeply nested conditions, and long parameter lists. By applying standardized naming conventions, Single Responsibility Principles (SRP), and robust error handling patterns, it helps developers transform complex, brittle codebases into self-documenting and maintainable software systems.

Key Features

01Implementation of SOLID principles (SRP, OCP, LSP, ISP, DIP) for better architecture

02Identification of code smells like Feature Envy, Primitive Obsession, and Long Methods

03Standardization of intent-revealing naming conventions for variables and classes

04Automated refactoring of large functions into Single Responsibility components

050 GitHub stars

06Optimization of error handling to prevent swallowed exceptions and maintain context

Use Cases

01Preparing code for a Pull Request (PR) review to ensure professional quality standards

02Improving codebase readability by renaming generic variables to reveal architectural intent

03Refactoring legacy 'God Classes' or functions exceeding 50 lines into manageable units

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add markky21/claude-skills clean-code

For use in Claude.ai and ChatGPT

Download Skill