Can this skill help with legacy code?

Yes, it is specifically designed to reconstruct the original intent and change model of existing code to identify where complexity has grown beyond the actual problem's requirements.

How does it measure code quality?

It uses 'mental hop cost,' which quantifies how many disparate concepts a developer must hold in their head simultaneously to understand a specific execution path.

Will it automatically refactor my code?

It provides a detailed report and 'Simplification Moves' (with code sketches), allowing the developer to review and validate the suggested architectural changes before implementation.

What principles does the Simplicity Review skill use?

It synthesizes Rich Hickey's 'Simple Made Easy' (reducing entanglements), Sandi Metz's 'The Wrong Abstraction' (preferring duplication over bad abstraction), and Kent Beck's 'Implementation Patterns'.

Simplicity Reviewer

Name: Simplicity Reviewer
Author: eliias

byeliias

•

개발자 도구

Evaluates codebases for overengineering and complexity using established architectural principles and simplicity heuristics.

The Simplicity Review skill is a specialized architectural auditor for Claude Code, designed to reduce technical debt and improve code maintainability. Rooted in the philosophies of Rich Hickey, Sandi Metz, and Kent Beck, it helps developers distinguish between essential and accidental complexity. The skill follows a rigorous 7-phase procedure—from reconstructing intent to identifying 'mental hop costs'—to provide a structured Simplicity Judgment. It is particularly effective at identifying 'the wrong abstraction,' challenging speculative extensibility, and proposing concrete simplification moves that make future modifications safer and more local.

주요 기능

01Includes counterargument generation to validate architectural trade-offs

02Provides concrete before-and-after sketches for simplification moves

031 GitHub stars

04Distinguishes between essential domain complexity and accidental implementation complexity

05Identifies and challenges speculative or leaky abstractions

06Quantifies code readability through 'mental hop cost' analysis

사용 사례

01Evaluating the 'fitness' of design patterns against expected future change models

02Performing architectural audits on complex pull requests to prevent premature abstraction

03Refactoring legacy codebases where the original intent has been obscured by layers of indirection

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add eliias/skills simplicity-review

For use in Claude.ai and ChatGPT