| name | detect-code-smells |
| description | Identify code quality issues and anti-patterns. Use when reviewing code for maintainability problems. |
| mcp_fallback | none |
| category | analysis |
| tier | 2 |
Detect Code Smells
Identify code quality issues, anti-patterns, and maintainability problems that suggest need for refactoring.
When to Use
- Code review before merging
- Identifying refactoring priorities
- Mentoring and code quality improvement
- Planning technical debt reduction
Quick Reference
# Python code smell detection
pip install pylint radon
pylint --disable=all --enable=convention,refactor module.py
radon cc -a module.py # Cyclomatic complexity
radon mi -s module.py # Maintainability index
Workflow
- Scan for patterns: Identify common code smell patterns (long functions, duplication, magic numbers)
- Check complexity: Measure cyclomatic and cognitive complexity
- Evaluate naming: Check for unclear variable/function names
- Review structure: Identify violations of SOLID principles
- Document findings: List smells with severity and recommendations
Output Format
Code quality report:
- Code smell type (duplication, long method, magic number, etc.)
- Location (file:line)
- Severity (critical/high/medium/low)
- Explanation of the issue
- Suggested fix or refactoring approach
References
- See CLAUDE.md > SOLID principles for design guidance
- See CLAUDE.md > DRY and KISS principles for quality standards
- See
refactor-codeskill for applying fixes