OpenParable
Skip to content
← Back to skills

Code Smell Detector

Testing & Quality
code-smell-detector

Code Smell Detector is an Agent Skill for testing & quality published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Automated detection of code smells and anti-patterns to identify refactoring opportunities

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/code-migration-modernization/skills/code-smell-detector/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/code-smell-detector, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Code Smell Detector Skill

Automated detection of code smells, anti-patterns, and design issues that indicate deeper problems in the codebase. This skill identifies refactoring opportunities and prioritizes them by impact.

Purpose

Enable systematic detection of code smells for:

  • Refactoring prioritization
  • Technical debt identification
  • Code quality improvement
  • Migration preparation
  • Design pattern violations

Capabilities

1. Long Method Detection

  • Identify methods exceeding line thresholds
  • Analyze parameter counts
  • Detect high cyclomatic complexity
  • Suggest extraction candidates

2. Large Class Identification

  • Detect classes with too many responsibilities
  • Identify god classes
  • Analyze class cohesion
  • Suggest decomposition strategies

3. Feature Envy Analysis

  • Find methods using other classes' data excessively
  • Identify misplaced functionality
  • Suggest method relocation
  • Map cross-class dependencies

4. Primitive Obsession Detection

  • Identify overuse of primitives
  • Find missing value objects
  • Detect stringly-typed code
  • Suggest domain type extraction

5. Parallel Inheritance Hierarchy

  • Detect mirrored class hierarchies
  • Identify inheritance coupling
  • Suggest hierarchy consolidation
  • Map inheritance relationships

6. Shotgun Surgery Detection

  • Identify changes requiring multiple file edits
  • Detect scattered functionality
  • Map change propagation patterns
  • Suggest consolidation points

7. God Class Identification

  • Detect classes doing too much
  • Analyze responsibility distribution
  • Calculate lack of cohesion metrics
  • Suggest single responsibility refactoring

Tool Integrations

ToolPurposeIntegration Method
SonarQubeCode smell detectionMCP Server / API
PMDJava smell detectionCLI
IntelliJ IDEAIDE-based analysisCLI / Export
DesigniteDesign smell detectionCLI
ast-grepPattern-based detectionMCP Server / CLI
ESLintJavaScript smell rulesCLI

Output Schema

{
  "analysisId": "string",
  "timestamp": "ISO8601",
  "target": {
    "path": "string",
    "filesAnalyzed": "number"
  },
  "smells": [
    {
      "type": "string",
      "severity": "high|medium|low",
      "file": "string",
      "line": "number",
      "element": "string",
      "description": "string",
      "metrics": {},
      "refactoringSuggestion": "string",
      "estimatedEffort": "string"
    }
  ],
  "summary": {
    "totalSmells": "number",
    "byType": {},
    "bySeverity": {},
    "hotspots": []
  }
}

Integration with Migration Processes

  • code-refactoring: Primary smell identification
  • technical-debt-remediation: Debt quantification
  • legacy-codebase-assessment: Quality assessment

Related Skills

  • static-code-analyzer: Broader quality analysis
  • refactoring-assistant: Smell remediation
  • dead-code-eliminator: Unused code removal

Related Agents

  • code-transformation-executor: Executes refactorings
  • technical-debt-auditor: Prioritizes debt remediation