Can I run this on specific files?

Yes, you can pass specific file paths as arguments to focus the audit on particular parts of your codebase.

What happens if I don't provide any arguments?

The skill automatically analyzes the git diff between your current branch and the main or master branch to find recent changes.

Does it fix the code automatically?

It provides a detailed analysis and specific suggestions for simplification, allowing you to review and apply the changes manually.

How does this skill detect over-engineering?

It analyzes architectural patterns and logic flow to identify where code is unnecessarily abstract or complex for its intended purpose.

Is this part of a larger plugin set?

Yes, it is part of the claude-plugins-vibe-workflow repository, which features a curated marketplace of tools for agentic development.

Code Simplicity Reviewer

Name: Code Simplicity Reviewer
Author: doodledood

bydoodledood

•

Collaboration Tools

Audits source code to identify over-engineering, premature optimization, and unnecessary cognitive complexity.

About

The review-simplicity skill acts as an automated quality assurance layer that ensures your codebase remains maintainable and lean. It leverages the code-simplicity-reviewer agent to scan your changes—either via specific file arguments or a git diff against the main branch—to flag architectural bloat and complex logic that could be simplified. This is particularly useful during code reviews to prevent technical debt and ensure that development workflows remain efficient by prioritizing readability and straightforward implementations over clever but fragile solutions.

Key Features

Automated git diff comparisons between branches
Analysis of cognitive complexity in functions and classes
8 GitHub stars
Detection of premature optimizations that hinder readability
Identification of over-engineered architectural patterns
Actionable suggestions for code simplification

Use Cases

Streamlining complex logic during active development phases
Refactoring legacy code to reduce technical debt
Pre-pull request audits to ensure clean code standards

About

Key Features

Automated git diff comparisons between branches
Analysis of cognitive complexity in functions and classes
8 GitHub stars
Detection of premature optimizations that hinder readability
Identification of over-engineered architectural patterns
Actionable suggestions for code simplification

Use Cases

Streamlining complex logic during active development phases
Refactoring legacy code to reduce technical debt
Pre-pull request audits to ensure clean code standards