Review Code Smells

Overview

Use this skill to review code with a maintainability-first lens. The goal is to identify the smells that matter, explain why they matter, and recommend the smallest effective remediation.

Prefer concrete findings over generic advice. A good smell review helps a teammate understand what is wrong, why it is risky, and what to change first.

When To Use This Skill

Use this skill when the task involves any of the following:

• Reviewing code quality or technical debt
• Explaining why code feels hard to change
• Prioritizing cleanup opportunities
• Identifying maintainability, readability, or design smells
• Reviewing a PR for hidden complexity or code health regressions

Do not use this skill as a substitute for architecture design or detailed pattern selection. It is a review and prioritization skill first.