Simplicity Reviewer

Reviews code for over-engineering, premature abstraction, and YAGNI violations.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/htxryan/claude-code-config-profiles --skill simplicity-reviewer-htxryan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Simplicity Reviewer
Source: https://github.com/htxryan/claude-code-config-profiles/tree/main/.agents/skills/compound/agents/simplicity-reviewer
Command: npx skills add https://github.com/htxryan/claude-code-config-profiles --skill simplicity-reviewer-htxryan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Codebases accumulate unnecessary complexity through premature abstractions, unused wrapper layers, and speculative features, making maintenance harder. This Skill reviews changed code to flag over-engineering and keep solutions as simple as correctness allows. ## Core Features & Use Cases - Complexity Detection: Identifies premature abstractions used in only one place, unnecessary indirection, and wrapper layers. - YAGNI Enforcement: Flags feature flags, config options, and "just in case" code that serve no current need. - Team Collaboration: Operates as a review-phase agent in an AgentTeam, forwarding security-obscuring complexity to the security-reviewer and boundary issues to the architecture-reviewer via SendMessage. - Use Case: During a pull request review, run this reviewer to confirm a new service layer is justified rather than a single-use abstraction, receiving an OVER-ENGINEERED, YAGNI, or OK verdict. ## Quick Start Ask the agent to review the current code changes for unnecessary complexity and over-engineering.

Frequently Asked Questions about Simplicity Reviewer

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

FAQPage Schema
How do I detect over-engineering in code reviews?▼

Review the changed code and ask whether a simpler solution would still be correct. Flag abstractions used in only one place, unnecessary wrapper layers, and configuration for single-use cases, then classify findings as OVER-ENGINEERED, YAGNI, or OK.

What is a YAGNI violation in code review?▼

A YAGNI violation is code built for hypothetical future needs rather than current requirements. Examples include feature flags for single-use cases, speculative configuration options, and "just in case" logic that no caller uses.

How does the Simplicity Reviewer work with other review agents?▼

It runs as an AgentTeam member in the review phase, spawned via TeamCreate. It forwards over-engineering that obscures security concerns to the security-reviewer and premature abstractions creating wrong module boundaries to the architecture-reviewer via SendMessage.

When should code complexity be considered acceptable?▼

Complexity is acceptable when it is required for correctness or genuinely shared across multiple call sites. The reviewer returns an OK verdict when the abstraction level matches the actual task requirements without speculative generality.

What are the limitations of automated simplicity review?▼

Simplicity judgment depends on understanding the code's context and future roadmap, so the reviewer may flag abstractions that are justified by planned work. It focuses on structural signals like single-use abstractions rather than domain-specific design tradeoffs.