code-smell-detection

Detect code smells and output evidence, locations, severity, and refactoring recipes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/HTRamsey/claude-config --skill code-smell-detection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-smell-detection
Source: https://github.com/HTRamsey/claude-config/tree/main/skills/code-smell-detection
Command: npx skills add https://github.com/HTRamsey/claude-config --skill code-smell-detection

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically detect code smells to guide safe refactoring.

Core Features & Use Cases

  • Categorization (Bloaters, Change Preventers, Couplers, Dispensables)
  • Refactoring recipes (Extract Method)
  • Prioritization for safe improvements

Quick Start

Run a quick smell scan on a module and document the planned refactors.

Frequently Asked Questions about code-smell-detection

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

FAQPage Schema
How do I detect code smells in my codebase?

Code smell detection identifies maintainability risks by categorizing problematic patterns—Bloaters, Change Preventers, Couplers, and Dispensables—with severity levels and concrete refactoring recipes to guide safe improvements.

What are code smells and why should I care about them during refactoring?

Code smells are structural indicators of maintainability problems that emerge during code reviews or onboarding. Detecting them early reveals refactoring targets and prevents complexity from accumulating into larger technical debt.

How do I prioritize code smells for refactoring?

Prioritization uses severity and evidence location data to rank refactoring targets. The Skill categorizes smells and provides extract method recipes, helping teams tackle high-impact maintainability risks first.

Can I use code smell detection during code reviews?

Yes. Code smell detection is designed for code reviews to systematically uncover maintainability risks before they compound, alongside complexity growth and unfamiliar codebase onboarding scenarios.

What refactoring techniques does code smell detection recommend?

The Skill outputs concrete refactoring recipes, including Extract Method techniques, tailored to the specific smell category and severity to support safe, guided improvements.