Cheickmec Smellcheck
- Updated March 25, 2026
- cheickmec/smellcheck
cheickmec-smellcheck is a Claude Code plugin that detects Python code smells using 82 patterns and 55 AST checks with refactoring guidance.
About
cheickmec-smellcheck is a Python-focused code smell detector and refactoring guide packaged so developers can wire it into Claude Code, local CLI, CI, or pre-commit without pulling a heavy analysis stack. It catalogs dozens of smell patterns and runs AST checks that surface design, control-flow, and idiomatic Python issues with enough structure for an agent to propose targeted refactors instead of vague cleanup. Developers shipping backends, CLIs, or small SaaS APIs use it when review time is scarce but they still want consistent quality signals before merge. Because it is zero-dependency and multi-surface, it fits workflows that mix agent assistance with traditional gates. It is not a full security audit or test runner; it complements review and testing skills by making maintainability problems visible early.
- 82 documented code-smell patterns with refactoring-oriented guidance
- 55 AST-based static checks with zero runtime dependency footprint
- Runs as Claude Code Agent Skills plugin, PyPI package, GitHub Action, or pre-commit hook
- Covers architecture, class design, control flow, immutability, and Python idioms
- Numbered catalog and metrics-oriented smell reporting for agent-led fixes
Cheickmec Smellcheck by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
/plugin install cheickmec-smellcheck@cheickmec/smellcheckAdd your badge
Show developers this plugin is listed on Skillselion. Paste this into your README.
| Last updated | March 25, 2026 |
|---|---|
| Repository | cheickmec/smellcheck ↗ |
What it does
Detect Python code smells with AST-backed checks and numbered refactoring guidance inside Claude Code, CI, or pre-commit before you merge.
Who is it for?
Best when you're maintaining Python services and want zero-dependency static analysis in the agent, pre-commit, or GitHub Actions.
Skip if: Non-Python stacks, pure security/compliance audits, or teams that only need formatting without design-smell depth.
What you get
You get consistent AST-backed smell reports and a numbered refactor catalog so Claude Code or CI can apply focused fixes before ship.
- Smell findings mapped to the 82-pattern catalog with refactor hints
- Repeatable AST check runs via agent, CLI, Action, or pre-commit
- Clearer review batches for agent-applied fixes on numbered issues
By the numbers
- 82 code-smell patterns documented
- 55 AST-based checks
- Zero third-party analysis dependencies stated
Recommended Plugins
0xbigboss Linear CliLinear CLI built with Zig1
15195999826 LomomarketplaceLomo's Claude Code Plugin Marketplace1
1broseidon MarketplaceCurated collection of Claude Code plugins for fullstack development teams1
4rgon4ut Cc Zig LspZig LSP plugin for Claude Code4
708u TwigSimplify git worktree and branch management with configurable symlinks, change carrying, and cleanup.22
8avalon8 AvalonclaudemarketAvalon 的 Claude Code 插件市场How it compares
Python AST smell catalog and refactor guide, not a multi-agent Factory-style delivery loop.
FAQ
Who is Cheickmec Smellcheck for?
Python-building developers and small teams who want structured smell detection in Claude Code plus optional PyPI, Action, or pre-commit wiring.
When should I use Cheickmec Smellcheck?
Use it during backend work and especially at Ship review whenever you merge Python changes and want AST-verified smell signals.
How do I add Cheickmec Smellcheck to my agent?
Install the smellcheck Agent Skills plugin for Claude Code from cheickmec/smellcheck, or install the PyPI package and point your skill or hooks at the same analyzer.