code-smell-detector

Detect code smells in Python modules and report fixes with examples.

1|Updated Nov 14, 2025
One-click install
npx skills add https://github.com/rysweet/AzureHayMaker --skill code-smell-detector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-smell-detector
Source: https://github.com/rysweet/AzureHayMaker/tree/main/.claude/skills/code-smell-detector
Command: npx skills add https://github.com/rysweet/AzureHayMaker --skill code-smell-detector

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automatically identifies and explains common code anti-patterns that violate best practices, such as over-abstraction or tight coupling. It provides concrete, actionable fixes, helping developers write cleaner, more maintainable, and philosophy-aligned code without extensive manual review.

Core Features & Use Cases

  • Anti-Pattern Detection: Automatically flags issues like large functions, complex inheritance, and missing public API definitions.
  • Actionable Fixes: Provides clear "BEFORE" and "AFTER" code examples with step-by-step refactoring guidance.
  • Philosophy Alignment: Explains how each detected smell violates core development principles, fostering better coding habits.
  • Use Case: During a code review, use this Skill to quickly pinpoint and resolve quality issues, ensuring new code adheres to team standards before merging.

Quick Start

Review this module for code smells and philosophy compliance: /path/to/module/

Frequently Asked Questions about code-smell-detector

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

FAQPage Schema
How do I identify code smells in my Python codebase?

Code smell detection automatically flags anti-patterns like large functions, complex inheritance, tight coupling, and missing public API definitions in Python modules. It surfaces these issues with location data, severity levels, and philosophy violation explanations to guide refactoring.

What code quality issues does automated detection catch during code review?

Automated detection catches over-abstraction, complex inheritance hierarchies, large functions, tight coupling, and missing __all__ definitions. Each issue includes before/after examples and step-by-step fix guidance aligned with development best practices.

Can I use code smell detection to enforce team coding standards?

Yes. The Skill flags violations against development philosophy during code review and refactoring sessions, providing actionable recommendations and impact assessments so new code adheres to team standards before merging.

What information does the detection provide for each code smell found?

For each smell, you get precise location data, severity level, philosophy violation explanation, concrete before/after code examples, step-by-step refactoring guidance, and impact assessment to understand consequences and next actions.

How does code smell detection improve code maintainability?

By identifying anti-patterns that reduce clarity and increase complexity, the Skill helps simplify code structure, reduce coupling, and enforce design consistency. This lowers maintenance burden and makes future changes safer and faster.