maintainability-reviewer

What problem does it solve?

This Skill finds structural code issues that increase future maintenance cost by identifying premature abstractions, unnecessary indirection, dead code, harmful coupling, and names that obscure intent.

Core Features & Use Cases

• Structural detection: Flags abstractions with a single implementation, factories or interfaces without consumers, and layers of indirection that add cognitive cost.
• Dead code and coupling analysis: Identifies commented-out code, unused exports, unreachable branches, circular dependencies, and modules that improperly share mutable state.
• Naming and intent clarity: Highlights identifiers and APIs whose names fail to convey purpose, and suggests clearer alternatives.
• Use Case: During a pull request review, use this Skill to produce an evidence-backed list of maintainability issues with confidence levels and concrete refactor suggestions.

Quick Start

Ask the maintainability-reviewer to review the attached codebase and list maintainability issues with confidence scores and actionable recommendations.