Review Clean Code

The review-clean-code skill enables AI agents to analyze codebases and identify areas requiring refactoring to improve maintainability. It specifically detects issues like overly complex functions, missing documentation, and inconsistent naming conventions across your project.

When to use it

• Before merging a large pull request to ensure new logic adheres to established style guides.
• During a codebase migration to spot legacy patterns that hinder modernization efforts.
• When onboarding new developers to quickly highlight areas needing clarity or simplification.
• As part of a CI/CD pipeline to automatically flag technical debt before deployment.

Key capabilities

• Identifies complex logic blocks and suggests breaking them into smaller functions.
• Detects missing comments, docstrings, or inline explanations for non-obvious code.
• Flags inconsistent variable naming, formatting errors, and redundant imports.
• Highlights potential security vulnerabilities related to poor coding practices.

Example prompts

• "Review the auth-service module and list three specific areas where the code could be simplified."
• "Analyze my recent changes in the payment-handler file for missing documentation or unclear variable names."
• "Scan the entire project for functions exceeding 50 lines of code and suggest refactoring strategies."

Tips & gotchas

This skill focuses on readability and structure rather than functional correctness; ensure your agent tests logic separately. For best results, provide context about your team's specific style guide or coding standards alongside the request.