simplify

Reviews code and docs for 11 categories of unnecessary complexity.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/vatsal2210/claude-skills --skill simplify-vatsal2210
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: simplify
Source: https://github.com/vatsal2210/claude-skills/tree/main/simplify
Command: npx skills add https://github.com/vatsal2210/claude-skills --skill simplify-vatsal2210

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simplify reduces unnecessary complexity in post-implementation code, docs, and scripts by identifying duplication, dead abstractions, over-engineering, clever/opaque constructs, state sprawl, import bloat, test cruft, config duplication, and prose drift across files. It helps teams avoid long-term maintenance tax by finding easy wins (inline a one-off helper, remove a needless retry loop) and by surfacing judgment calls that require human approval.

Core Features & Use Cases

  • Targeted post-implementation review: Focuses on the files changed in the current session or a user-provided scope to avoid global churn.
  • 11-category taxonomy: Produces findings across Duplication, Dead Abstractions, Over-engineering (YAGNI), Unclear/Clever Code, State Sprawl, Premature Error Handling, Comment Rot, Import Surface, Test Cruft, Config Duplication, and Cross-file Divergence.
  • Actionable Phase 2 report: Each finding includes path:line ranges, a short code quote, a proposed replacement, estimated savings, and risk level so users can approve precise edits.
  • Use Case examples: Ask it after a feature lands to prune complexity, run it after gap-check flags quality debt, or paste a long function and request a leaner implementation.

Quick Start

Ask simplify to review the changed files in this session and produce a Phase 2 findings report listing categorized simplification suggestions.

Frequently Asked Questions about simplify

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

FAQPage Schema
How do I find over-engineering and dead abstractions in TypeScript code?

You can identify over-engineering and dead abstractions by running a post-implementation code review that classifies complexity into eleven predefined categories. The review generates a report with file:line ranges, proposed replacements, and risk ratings to help you prune unnecessary abstractions without modifying code directly.

What is the best way to review changed files for code duplication and test cruft?

The best way to review changed files for code duplication and test cruft is to apply a session-scoped review that targets only recently modified files. This approach categorizes findings into specific areas like test cruft and config duplication, outputting a report with estimated savings and risk levels to guide precise refactoring.

How do I reduce state sprawl and import surface issues after a feature lands?

To reduce state sprawl and import surface issues after a feature lands, perform a targeted post-implementation review. This process scans your changed code to surface findings across eleven complexity categories, providing concise now versus proposed comparisons and risk ratings for safe refactoring.

Can I refactor a pasted code snippet for readability without scanning the whole project?

Yes, you can refactor a pasted code snippet for readability without scanning the whole project. The review process accepts a pasted snippet as its scope, analyzing it for unclear clever code and over-engineering to produce a focused findings report with proposed replacements and savings estimates.

Does this code review approach automatically fix premature error handling and comment rot?

No, this code review approach does not automatically fix premature error handling and comment rot. It operates in a read-only Phase 2 report mode, identifying these issues alongside cross-file divergence and providing proposed replacements and risk ratings for human approval before any edits are made.