Does it provide examples of how to fix the code?

Yes, it includes a robust reference library with 'before' and 'after' code snippets for every numbered pattern to ensure you understand the trade-offs of each change.

Does it require any external dependencies to run?

No, the skill includes a bundled version of the smellcheck package that runs using standard Python 3, requiring no additional pip installations for immediate use.

How do I trigger the refactoring analysis?

You can invoke the skill by using the /refactor command or by asking Claude to 'analyze this code for smells' or 'clean up this Python module' specifically.

Can I use this for architectural-level refactoring?

Yes, the skill includes an 'architecture_first' strategy that prioritizes fixing cross-file dependencies and coupling before moving to local function-level cleanups.

What types of issues can this skill detect?

It identifies 56 distinct issues including deep nesting, long functions, mutable default arguments, and complex OO metrics like Lack of Cohesion of Methods (LCOM).

Python Refactoring & Code Smell Detector

Name: Python Refactoring & Code Smell Detector
Author: cheickmec

bycheickmec

0•

Developer Tools

Refactors Python code using 83 industry-standard patterns to eliminate technical debt and improve software architecture through automated AST analysis.

This skill provides a comprehensive catalog of 83 refactoring patterns derived from Fowler, Contieri, and OO metrics to help developers systematically clean up Python codebases. It features an automated AST-based smell detector that identifies 56 unique issues—ranging from simple naming problems and mutable default arguments to complex architectural coupling and low cohesion—and provides a guided, multi-phase workflow for improvement. Whether you are addressing deep nesting or high class coupling, this plugin offers specific before/after examples and dependency-aware refactoring plans to ensure production-grade code quality with zero external dependencies.

Key Features

01Detailed reference library providing 'before' and 'after' implementation examples for every pattern.

02Zero-dependency execution via bundled scripts that work immediately upon installation.

03Multi-phase guided workflow that generates customized refactoring plans based on findings.

040 GitHub stars

05Automated detection of 56 code smells using AST analysis and OO metrics.

06Comprehensive catalog of 83 refactoring patterns covering immutability, class design, and control flow.

Use Cases

01Automating code quality reviews to catch smells like feature envy, shotgun surgery, or law of demeter violations.

02Improving object-oriented design through metrics-based analysis of cohesion, coupling, and fan-out.

03Modernizing legacy Python codebases by identifying and fixing deep-rooted technical debt.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cheickmec/smellcheck python-refactoring

For use in Claude.ai and ChatGPT

Download Skill