simplify

Reviews recently changed code for reuse, quality, and efficiency issues and applies targeted fixes.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/skills --skill simplify-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: simplify
Source: https://github.com/leonardoacosta/skills/tree/main/leo-core/skills/simplify
Command: npx skills add https://github.com/leonardoacosta/skills --skill simplify-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After implementing a feature, diffs often accumulate over-engineering: single-use abstractions, misleading type assertions, dead branches, and inefficient patterns. This Skill reviews only the changed code, classifies each issue, and applies minimal targeted fixes so reviews stay focused and cognitive load drops. ## Core Features & Use Cases - Diff-scoped review: Analyzes only recent changes via git diff, classifying signals like single-use abstractions, any casts, async functions without await, and barrel export bloat. - Efficiency checks: Detects N+1 queries, sync calls in async contexts, redundant fetches, over-fetching, and unnecessary React re-renders. - Cut-format over-engineering report: When asked what to delete, produces a scannable one-line-per-finding report with tags like delete:, stdlib:, yagni:, and a net-lines metric, at lite, full, or ultra intensity. - Use Case: After finishing a TypeScript feature, ask for a simplify pass to inline a helper used once, unwrap a single-promise Promise.all, and batch a per-item database loop before opening the PR. ## Quick Start Ask the assistant to simplify the code in my current git diff and fix any over-engineering it finds.

Frequently Asked Questions about simplify

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

FAQPage Schema
How do I review my code changes for over-engineering before a pull request?

Run a diff-scoped simplify pass over your git diff. It classifies each change against known signals like single-use abstractions and unnecessary async, then applies small targeted fixes and verifies with tsc and tests.

How to detect and fix N+1 queries in TypeScript code?

The efficiency check flags loops that call a database or API per item. The fix batches them with findMany(ids) or Promise.all, and similar checks cover redundant fetches, over-fetching, and sync calls inside async functions.

What is the difference between simplify and whole-codebase dead code removal?

Simplify is diff-scoped only: it reviews recent changes for reuse, quality, and efficiency. For removing dead code across an entire codebase, use the reducing-entropy skill instead, as noted in the skill description.

Can I control how aggressive the simplification pass is?

Yes, three intensity levels exist: lite names alternatives without applying changes, full is the default with the cut-format enforced, and ultra prioritizes deletion. No level removes validation, security, or accessibility code.

When should I not use a diff-scoped code review?

Avoid it for whole-codebase cleanup, correctness or security audits, and large refactors. The skill never fixes code outside the diff and stops to ask before any change touching more than 20 lines or crossing file boundaries.