What problem does it solve?
This Skill enforces pragmatic coding standards to ensure code is maintainable, readable, and efficient, preventing over-engineering and unnecessary complexity.
Core Features & Use Cases
- Enforces SOLID principles: Promotes Single Responsibility, DRY, KISS, and YAGNI.
- Standardizes Naming Conventions: Ensures clear and intent-revealing names for variables, functions, and constants.
- Optimizes Function Design: Guides developers to write small, focused functions with minimal arguments and no side effects.
- Promotes Clean Structure: Encourages guard clauses, flat code, and composition over deep nesting.
- AI Coding Style: Directs AI agents to write code directly, fix bugs, and ask clarifying questions when requirements are unclear.
- Pre-edit Checks: Mandates thinking about file dependencies and potential impacts before making changes.
- Post-completion Self-Checks: Ensures all requirements are met, code is functional, and tests pass before task completion.
- Mandatory Script Verification: Outlines specific scripts for various specialists to run for validation and error reporting.
Quick Start
Use the clean-code skill to refactor the provided UserService.ts file to adhere to the Single Responsibility Principle.