clean-code

Enforce Clean Code principles for writing, reviewing, and refactoring software.

2|Updated Feb 6, 2026

Search Tags:#code review #best practices #refactoring #clean code #readability #maintainability

Ready to run

npx skills add https://github.com/bcastelino/agent-skills-kit --skill clean-code-bcastelino

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/bcastelino/agent-skills-kit/tree/main/skills/clean-code
Command: npx skills add https://github.com/bcastelino/agent-skills-kit --skill clean-code-bcastelino

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers write, review, and refactor code to adhere to the principles of "Clean Code," ensuring high quality, readability, and maintainability.

Core Features & Use Cases

Code Quality Improvement: Enforces best practices for naming, functions, comments, formatting, and more.
Refactoring Guidance: Identifies and suggests improvements for code smells and design principles.
Use Case: When reviewing a complex function, use this Skill to check if it adheres to the principles of being small, doing one thing, and having a single level of abstraction.

Quick Start

Apply clean code principles to the provided Python function.

Frequently Asked Questions about clean-code

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

FAQPage Schema

How do I improve code readability and maintainability when refactoring?▼

Clean code principles improve readability and maintainability by enforcing meaningful naming, small single-purpose functions, single abstraction levels, and proper formatting.

What are the best practices for writing clean functions and handling errors?▼

Best practices for clean functions include keeping them small, ensuring they do one thing, maintaining a single level of abstraction, and applying robust object-oriented principles for error handling.

How do I identify code smells during a code review?▼

Identify code smells during a code review by checking for violations of clean code principles, looking for complex functions, poor naming, and improper error handling to guide refactoring efforts.

Does this clean code approach apply to object-oriented programming and unit testing?▼

Yes, this approach applies to object-oriented programming and unit testing by enforcing design principles, proper formatting, and best practices to ensure high-quality, readable, and maintainable software.

When should I refactor software to follow clean code principles?▼

You should refactor software to follow clean code principles when code reviews reveal complex functions, poor readability, maintainability issues, or violations in naming, formatting, and error handling best practices.