Can I target specific parts of my codebase?

Yes, you can run the command on specific paths or use glob patterns to analyze individual services, directories, or file types.

What kind of 'Gold Plating' does it detect?

It flags features that exceed documented requirements, such as configurability that is never utilized or extensibility points that have never been extended.

How does this skill help reduce technical debt?

It identifies 'dead' abstractions and unnecessary architectural layers that increase maintenance costs, providing a clear roadmap to simplify the codebase.

What is speculative generality?

Speculative generality occurs when code is written to handle potential future requirements that do not yet exist, often leading to unused abstractions and excessive complexity.

Does it provide actionable refactoring advice?

Yes, every report includes a simplification roadmap categorized by effort level (Low, Medium, High) and the projected impact on code complexity.

Detect Over-Engineering

Name: Detect Over-Engineering
Author: melodic-software

bymelodic-software

•

Developer Tools

Identifies and simplifies unnecessary code complexity, speculative abstractions, and architectural bloat to streamline software development.

The Detect Over-Engineering skill empowers developers to maintain lean codebases by identifying 'Astronaut Architecture,' premature abstractions, and unused flexibility points. By scanning for patterns like single-implementation interfaces, unused generic parameters, and unnecessary factory patterns, it helps teams reduce maintenance overhead and technical debt. Whether you are conducting a code review or optimizing a legacy system, this skill provides actionable simplification roadmaps, including estimated lines of code that can be removed and impact scores for potential refactors.

Key Features

01Provides a structured simplification roadmap with estimated effort levels.

0238 GitHub stars

03Detects premature abstractions including excessive dependency injection and factory patterns.

04Calculates potential complexity score improvements and reducible abstraction layers.

05Identifies speculative generality like interfaces with single implementations.

06Spots 'Gold Plating'—features and configurations that exceed documented requirements.

Use Cases

01Auditing legacy codebases to identify and prune architectural bloat.

02Simplifying technical debt by removing unused extensibility points and 'just-in-case' code.

03Automating code reviews to flag unnecessary complexity before it is merged.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add melodic-software/claude-code-plugins detect-over-engineering

For use in Claude.ai and ChatGPT

Download Skill