skills.rest
trevorbyrum
trevorbyrumCOMMUNITY
Explore all skills by this author →
GitHub

refactor-review

Detects duplication, over-engineering, inconsistency, and code drift in repositories.

1|1|Updated Mar 9, 2026
Search Tags:#quality assurance#code review#refactoring#maintainability#code audit#code simplification
One-click install
npx skills add https://github.com/trevorbyrum/claude-skills-suite --skill refactor-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactor-review
Source: https://github.com/trevorbyrum/claude-skills-suite/tree/main/skills/refactor-review
Command: npx skills add https://github.com/trevorbyrum/claude-skills-suite --skill refactor-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses code quality and efficiency issues by identifying over-engineering, duplication, bloat, truncated code, and inconsistencies, helping to simplify and maintain codebases.

Core Features & Use Cases

  • Code Simplification: Detects and flags unnecessary complexity and abstractions.
  • Duplication Detection: Identifies repeated code blocks that should be refactored into shared utilities.
  • Consistency Audit: Ensures adherence to project patterns and conventions.
  • Use Case: Before a major refactoring effort, run this skill to get a prioritized list of areas that would benefit most from cleanup, preventing the accumulation of "AI cruft."

Quick Start

Run a full scan to find and report on code duplication and over-engineering.

Frequently Asked Questions about refactor-review

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

FAQPage Schema
How do I detect code duplication and over-engineering before refactoring?▼

To detect code duplication and over-engineering before refactoring, run a full codebase scan that flags unnecessary complexity, repeated code blocks, and abstractions to produce a prioritized cleanup list.

What is code drift and how does it affect maintainability?▼

Code drift occurs when implementation diverges from project context and feature documentation, reducing maintainability. Auditing identifies these inconsistencies and recommends specific refactoring steps to realign the codebase.

Can I audit my codebase for consistency against project conventions?▼

Yes, you can audit a codebase for consistency by comparing code against project context and feature documentation, which ensures adherence to established patterns and flags inconsistencies for correction.

What is the best way to prevent AI cruft from accumulating in my code?▼

The best way to prevent AI cruft is to run a quality audit that identifies bloat, truncated code, and unnecessary abstractions, providing a prioritized list of areas that benefit most from simplification.

Does this code review process require specific dependencies or frameworks?▼

No, this code review and refactoring analysis process requires no external dependencies, allowing you to directly scan a codebase for efficiency issues, duplication, and inconsistencies without prerequisite packages.

Why should I use an automated code audit instead of manual review?▼

An automated code audit compares code against feature documentation to detect drift and over-engineering systematically, whereas manual review often misses subtle duplications and accumulated bloat across large codebases.

Related Skills

Explore More Software Engineering Skills→
thiagoooo34252thiagoooo34252
1

sdd-explore

Explore codebases and generate structured analysis reports.

Community
Intermediate
heyAyushhheyAyushh
3

simplify

Refactor code to remove redundancy and align with repository style.

Community
Basic
R2W1csR2W1cs
1

lint-and-validate

Lint and validate JavaScript and Python code for syntax and style issues.

Community
Intermediate
ArtisanClarinetsArtisanClarinets

documentation-writing

Standardize technical documentation writing for READMEs, API docs, and engineering guides.

Community
Basic