Code Smell Detector
This detector enforces amplihack's zero-BS philosophy by catching five specific anti-patterns: over-abstraction (like ABC classes with one implementation), complex inheritance chains deeper than two levels, functions over 50 lines, tight coupling from hardcoded dependencies, and missing `__all__` exports. It's built for code review and refactoring sessions where you want to keep things ruthlessly simple. The skill gives you specific fixes with before/after examples, not just complaints. Run it when you're reviewing PRs or when that nagging feeling hits that your code is getting too clever for its own good. It's opinionated about composition over inheritance and direct implementation over future-proofing, which won't suit every team but keeps complexity in check.
- skills.sh installs
- 252
- GitHub stars
- 76
- last updated
- Aug 21, 2026
Install
$ npx -y skills add rysweet/amplihack --skill code-smell-detector --agent claude-codeInstalls into .claude/skills of the current project.
Files
Code Smell Detector Skill
Purpose
This skill identifies anti-patterns that violate amplihack's development philosophy and provides constructive, specific fixes. It ensures code maintains ruthless simplicity, modular design, and zero-BS implementations.
When to Use This Skill
- Code review: Identify violations before merging
- Refactoring: Find opportunities to simplify and improve code quality
- New module creation: Catch issues early in development
- Philosophy compliance: Ensure code aligns with amplihack principles
- Learning: Understand why patterns are problematic and how to fix them
- Mentoring: Educate team members on philosophy-aligned code patterns
Core Philosophy Reference
Amplihack Development Philosophy focuses on:
- Ruthless Simplicity: Every abstraction must justify its existence
- Modular Design (Bricks & Studs): Self-contained modules with clear connection points
- Zero-BS Implementation: No stubs, no placeholders, only working code
- Single Responsibility: Each module/function has ONE clear job
Code Smells Detected
1. Over-Abstraction
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/rysweet/amplihack
- Category
- Code Review & Quality
- First seen
- Jun 3, 2026
More from rysweet/amplihack
All 58- Sociologist Analyst251
- Backlog Curator250
- Engineer Analyst249
- Investigation Workflow249
- Pm Architect245
- Historian Analyst244
- Xlsx244
- Code Visualizer242
- Urban Planner Analyst242
- Debate Workflow240
- Environmentalist Analyst236
- Futurist Analyst235
- Meeting Synthesizer228
- Skill Builder227
- Pr Review Assistant225
- Epidemiologist Analyst224
- Context Management170
- Model Evaluation Benchmark160
- Goal Seeking Agent Pattern157
- Poet Analyst156
- Azure Devops154
- Email Drafter154
- Ethicist Analyst152
- Lsp Setup151
Recommended
More Code Review & Quality
domain-architectpproenca/dot-skillsDiscovers business domains in a Swift codebase by tracing what users can DO — not by reading folder names or architecture docs. Maps each domain's vertical slic242skills.sh installs
senior-architectborghei/claude-skillsSystem architecture design and review. Use when designing architecture, evaluating microservices vs monolith, writing ADRs, choosing a database, planning for sc239skills.sh installs
code-review-assistantjorgealves/agent_skillsProvides automated, context-aware code reviews focusing on logic errors and style violations. Use during Pull Request cycles to identify potential bugs and main221skills.sh installs
review-pryonatangross/orchestkitPR review using parallel specialized agents for code quality, security, testing, architecture, and performance analysis. Synthesizes findings into a review repo217skills.sh installs
code-reviewjwilger/agent-skillsThree-stage code review protocol covering spec compliance, code quality, and domain integrity. Use this skill whenever the user asks to review code, prepare or 163skills.sh installs
Security Architectdaffy0208/ai-dev-standardsComprehensive security architecture combining threat modeling, security-first design, secure coding review, and compliance validation. Consolidated from threat-0skills.sh installs