detect-code-smells

Identify code quality issues and anti-patterns. Use when reviewing code for maintainability problems.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/detect-code-smells

SKILL.md

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

bash

# 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-code skill for applying fixes