design-smell-detector

Detect design smells in Python codebases via static AST analysis.

142|14|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/ArabelaTso/Skills-4-SE --skill design-smell-detector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-smell-detector
Source: https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/design-smell-detector
Command: npx skills add https://github.com/ArabelaTso/Skills-4-SE --skill design-smell-detector

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automatically identifies common design flaws (code smells) in Python code, helping developers improve code quality, maintainability, and reduce technical debt.

Core Features & Use Cases

  • Automated Smell Detection: Analyzes code for issues like God Classes, High Coupling, Low Cohesion, Long Methods, and High Complexity.
  • Actionable Suggestions: Provides specific recommendations for refactoring and improving code design.
  • Use Case: Integrate this Skill into your CI pipeline to automatically flag code with critical design smells before they are merged, ensuring consistent code quality across the team.

Quick Start

Run the design smell detector on the 'src/' directory to find and report any code smells.

Frequently Asked Questions about design-smell-detector

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

FAQPage Schema
How do I detect code smells in a Python codebase?

To detect code smells in a Python codebase, use static analysis of Python Abstract Syntax Trees (AST) to identify patterns indicative of design flaws like God Classes, High Coupling, and Long Methods. This provides actionable refactoring suggestions to improve maintainability.

What are common Python design smells and how are they identified?

Common Python design smells include God Classes, High Coupling, Low Cohesion, Long Methods, and High Complexity. They are identified by analyzing Python codebases for coupling, cohesion, complexity, and size violations through AST static analysis.

Can I run static analysis for refactoring opportunities in a CI pipeline?

Yes, you can integrate static analysis for refactoring opportunities into your CI pipeline to automatically flag Python code with critical design smells before merging. This enforces consistent code quality standards and reduces technical debt across your team.

Does the design smell detector work with Python frameworks without external dependencies?

Yes, the design smell detector works with Python codebases directly and requires no external dependencies. It uses Python Abstract Syntax Trees (AST) to perform static analysis and identify structural design flaws within your source directory.

What is the best way to find God Classes and high coupling in Python?

The best way to find God Classes and high coupling in Python is by running static analysis focused on coupling, cohesion, complexity, and size violations. This identifies structural design flaws and provides specific recommendations for refactoring.