clean-code

To enforce clean code standards with an AI agent, apply guidelines focusing on conciseness, directness, and maintainability. This skill uses mandatory self-checks and verification scripts to ensure generated code adheres to principles like SRP, DRY, and KISS before task completion.

To improve maintainability and developer productivity, apply standards including Single Responsibility, Don't Repeat Yourself, Keep It Simple, and the Boy Scout Rule. These principles ensure concise, direct code free from over-engineering and unnecessary comments.

To refactor code following SOLID principles and improve naming conventions, optimize function design by creating small, focused functions with minimal arguments and no side effects. Ensure variables and constants use clear, intent-revealing names for better readability.

Yes, this clean code skill works without external dependencies or libraries. It relies entirely on internal scripts and references to provide pragmatic coding guidelines and execute verification checks for code quality and standards adherence.

To prevent over-engineering and unnecessary comments in AI-generated code, apply the You Ain't Gonna Need It principle and specific AI guidelines. This ensures agents respond directly to requests, handle unclear requirements properly, and produce maintainable code.

The best way to structure functions for clean code is to use guard clauses, flat nesting, and composition. Design small, focused functions with minimal arguments and no side effects to ensure high maintainability and clear, direct logic.