maintainability-code-review

Identify maintainability issues in functionally correct code using a structured checklist.

17|10|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/Wetty-Technology/wetty-chat --skill maintainability-code-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintainability-code-review
Source: https://github.com/Wetty-Technology/wetty-chat/tree/main/.agents/skills/maintainability-code-review
Command: npx skills add https://github.com/Wetty-Technology/wetty-chat --skill maintainability-code-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifies and remedies maintainability issues in code that is functionally correct, enabling teams to improve readability, structure, and long-term quality without introducing bugs.

Core Features & Use Cases

  • Dead / Compatibility-Only Code: Detects stale or obsolete branches, feature flags that are always on/off, and shim layers, enabling safe removal.
  • Duplicate / Redundant Code: Flags repeated logic and opportunities to extract shared utilities to reduce drift.
  • Hard-Coded Values / Magic Strings: Highlights domain-value literals that should be centralized for configurability and consistency.
  • Naming Quality & Single Responsibility: Audits naming accuracy and ensures functions/classes have a single, clear responsibility.
  • Error Handling Consistency: Promotes uniform and contextual error handling across modules.
  • Dependency Direction & Visibility: Checks for inappropriate module dependencies and unnecessary exposure.

Quick Start

Perform a maintainability review on the target codebase by running through the checklist and documenting findings with suggested refactors.

Frequently Asked Questions about maintainability-code-review

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

FAQPage Schema
How do I find maintainability issues in legacy code without altering behavior?

To find maintainability issues in legacy code without altering behavior, analyze the codebase against a structured checklist covering dead code, duplicate logic, magic strings, and complex structures. This identifies readability and structural flaws while documenting actionable refactoring steps to ensure long-term quality.

What is the best way to detect dead code and obsolete feature flags during a refactor?

The best way to detect dead code and obsolete feature flags during a refactor is to audit the codebase for stale branches, compatibility-only shim layers, and flags that are always on or off. This enables safe removal of redundant logic and reduces drift across modules.

Can I audit naming quality and single responsibility in modules with patchy documentation?

Yes, you can audit naming quality and single responsibility in modules with patchy documentation by applying a maintainability review checklist. This enforces naming accuracy and verifies that functions and classes have a single, clear responsibility, detailing actionable improvement steps for better long-term quality.

How do I check dependency direction and visibility for coding standards compliance?

To check dependency direction and visibility for coding standards compliance, review module dependencies to identify inappropriate coupling and unnecessary exposure. This enforces uniform error handling consistency and ensures structural quality without introducing functional bugs.

What are the limitations of static analysis for maintaining functionally correct code?

The limitations of static analysis for maintaining functionally correct code involve focusing primarily on readability, structure, and long-term quality rather than runtime execution. It identifies hard-coded values and duplicate logic but requires manual execution of suggested refactoring steps to achieve actual improvements.