detect-code-smells

Detect code smells and complexity issues in codebases.

18|5|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/HomericIntelligence/ProjectOdyssey --skill detect-code-smells-homericintelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: detect-code-smells
Source: https://github.com/HomericIntelligence/ProjectOdyssey/tree/main/.claude/skills/tier-2/detect-code-smells
Command: npx skills add https://github.com/HomericIntelligence/ProjectOdyssey --skill detect-code-smells-homericintelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pylint, radon, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of maintaining high code quality by identifying potential issues like anti-patterns, complexity, and maintainability problems that hinder development.

Core Features & Use Cases

  • Code Smells Identification: Detects common issues such as long functions, code duplication, and magic numbers.
  • Complexity Measurement: Assesses cyclomatic and cognitive complexity to gauge understandability.
  • Structural Review: Checks for violations of software design principles like SOLID.
  • Use Case: During a code review, this Skill can automatically flag sections of code that are overly complex or violate established coding standards, prompting refactoring before merging.

Quick Start

Use the detect-code-smells skill to analyze the Python file '/path/to/your/module.py' for code quality issues.

Frequently Asked Questions about detect-code-smells

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect code smells and anti-patterns in a Python codebase?

To detect code smells, this Skill uses static analysis tools to scan your Python files for anti-patterns, complexity, and duplication. It identifies long functions, magic numbers, and SOLID violations to assess technical debt.

What is the best way to measure cyclomatic complexity during a code review?

Measuring cyclomatic complexity is handled by applying static analysis to gauge code understandability and maintainability. It calculates complexity metrics automatically to flag overly complicated sections before merging.

Can I use pylint to check for SOLID design principle violations?

Yes, pylint is utilized by this Skill to perform structural reviews and check for violations of software design principles like SOLID. It scans the codebase to identify anti-patterns that hinder development.

Does this code review tool require radon to assess technical debt?

Yes, radon is a required dependency to assess technical debt and measure cognitive complexity. Combined with pylint, it scans codebases to identify maintainability problems and prioritize refactoring tasks.

How do I prioritize refactoring for code duplication and maintainability issues?

Prioritizing refactoring is achieved by scanning for code smells like duplication and high complexity. The Skill flags sections that violate coding standards, helping you target the most critical maintainability problems first.