principle-clean-code

What problem does it solve?

This Skill helps you transform messy, hard-to-read code into clean, intention-revealing functions by enforcing practical conventions for naming, structure, duplication, and error handling.

Core Features & Use Cases

• Function clarity rules: keeps functions small, focused, and composable by targeting length, argument count, and Command-Query Separation.
• Intent-revealing naming: guides naming to express meaning directly (including positive booleans) and avoids misleading abbreviations or Hungarian notation.
• Refactoring guardrails: balances DRY (Rule of Three), KISS, YAGNI, and scope-bounded cleanup via the Boy Scout Rule while avoiding over-abstraction.
• Error-handling consistency: encourages handling errors at the appropriate layer without silently swallowing failures.

Quick Start

Ask an AI to review the attached function and rewrite it to meet clean-code rules for naming, function length, argument count, and error handling.