code-smell-detective

Detect and report code smells with prioritized findings and refactors.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/FrogAi/Xenopus --skill code-smell-detective
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-smell-detective
Source: https://github.com/FrogAi/Xenopus/tree/main/Gemini/Skills/Gemini%203.1%20Pro/code-smell-detective
Command: npx skills add https://github.com/FrogAi/Xenopus --skill code-smell-detective

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Production-grade code-smell detection that identifies maintainability and quality issues in a codebase and returns a ranked report with actionable refactors; it does not modify source code.

Core Features & Use Cases

  • Live taxonomies and per-language thresholds are pulled to classify smells such as long functions, deep nesting, god classes, primitive obsession, duplicated code, and data clumps.
  • Returns a ranked list of findings with file:line, smell category, severity, and a suggested refactor, plus citations to sources.
  • Works on file, directory, or whole repository scopes and can be integrated into PR reviews, CI checks, or pre-commit workflows.

Quick Start

Run the skill on a repository to generate a prioritized code-smell report with suggested refactors across the codebase.

Frequently Asked Questions about code-smell-detective

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

FAQPage Schema
How do I detect code smells and get refactoring suggestions for my repository?

Code smell detection analyzes your repository to identify maintainability issues like long functions and god classes, returning a ranked list of findings with file paths, line numbers, severity levels, and suggested refactors.

Can I use local linter configurations like .eslintrc and .pylintrc for static analysis thresholds?

Yes, static analysis applies language-specific thresholds pulled from local configuration files including .eslintrc, .pylintrc, rubocop.yml, and clippy.toml to classify code smells according to your project standards.

What is the best way to prioritize technical debt and code quality issues in a large codebase?

Prioritizing code quality issues involves generating a ranked report categorized by severity and smell type, which helps teams tackle the most critical maintainability problems first. The report includes a verdict on overall quality using a defined confidence model.

Does code smell detection work for pull request reviews and CI checks?

Yes, code smell detection works on file, directory, or whole repository scopes and can be integrated into pull request reviews, CI checks, or pre-commit workflows to catch maintainability issues early.

How are code smells classified when running static analysis on my codebase?

Code smells are classified by fetching live smell taxonomies to identify issues like deep nesting, primitive obsession, duplicated code, and data clumps. Each finding includes tool corroboration and citations to authoritative sources.

Will code smell detection automatically modify my source code during refactoring?

No, code smell detection does not modify source code. It returns a prioritized report with actionable refactoring suggestions and structured evidence blocks, leaving the actual code changes to the developer.