check-anti-patterns

Detect design anti-patterns in Python code using AST-based analysis.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/sunLeee/optimization --skill check-anti-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-anti-patterns
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/quality/check/anti-patterns
Command: npx skills add https://github.com/sunLeee/optimization --skill check-anti-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detect and report design anti-patterns in Python code, enabling teams to identify architectural and maintainability risks early.

Core Features & Use Cases

  • Anti-pattern detection: identifies God Class, Long Method, Long Parameter List, Feature Envy, Circular Dependency, Magic Number, and ADK-specific duplicate validations.
  • Code quality guidance: provides actionable refactor suggestions with severity levels to prioritize fixes.
  • Use Case: scan a codebase to surface top offenders and guide targeted refactoring in the next sprint.

Quick Start

Run the anti-pattern checker on your Python project to surface high-risk patterns and recommended improvements.

Frequently Asked Questions about check-anti-patterns

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

FAQPage Schema
How do I detect Python anti-patterns like God Class and Long Method in my codebase?

Detect Python anti-patterns by scanning your codebase with AST-based analysis to surface design flaws like God Class and Long Method. It identifies these structural risks and quantifies severity to help prioritize refactoring efforts.

What is the best way to find circular dependencies and feature envy in Python code?

Find circular dependencies and feature envy using heuristic static analysis on Python directories. The scanner evaluates method interactions and module imports to pinpoint exactly where architectural coupling violates maintainability standards.

Can I scan a specific directory for Python code quality issues and magic numbers?

Yes, you can scan targeted directories for Python code quality issues and magic numbers. The analyzer traverses specified paths to uncover hardcoded values and ADK duplicate validations, providing actionable refactor suggestions with severity levels.

Does this static analysis tool provide concrete refactoring suggestions for long parameter lists?

Yes, this static analysis tool provides concrete refactoring suggestions for long parameter lists. It evaluates AST structures to detect excessive arguments and outputs prioritized guidance to reduce complexity and improve overall code maintainability.

How do I quantify the severity of design anti-patterns to prioritize my next sprint refactoring?

Quantify the severity of design anti-patterns by running heuristic analysis across your project. The tool scores each detected pattern, such as Long Method or God Class, allowing teams to rank top offenders and guide targeted refactoring.