simplify

Identify behavior-preserving simplifications in code diffs with evidence-based verdicts.

1|1|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/luan/agents --skill simplify-luan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: simplify
Source: https://github.com/luan/agents/tree/main/skills/simplify
Command: npx skills add https://github.com/luan/agents --skill simplify-luan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps reviewers and authors find simpler, smaller, more idiomatic changesets by identifying confirmed opportunities to remove unnecessary complexity before deeper review.

Core Features & Use Cases

  • Scope-aware simplification: Uses the same diff-source rules as $crit and inspects the actual changed code, not just summaries.
  • Depth control for efficiency: Chooses direct inspection for small diffs and dispatches a focused simplifier approach for larger or multi-area changes.
  • Evidence-gated recommendations: Produces a PASS or SIMPLIFY_RECOMMENDED verdict only when each finding clearly answers what to change, why it is behavior-preserving or lower risk, what local pattern proves it, and what verification to run.
  • Optional automated fixes: Applies only confirmed, behavior-preserving simplifications when --auto is present or when explicitly requested.

Quick Start

Ask the AI to simplify your diff by running: simplify <base..head> --auto.

Frequently Asked Questions about simplify

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

FAQPage Schema
How do I find unnecessary complexity and dead code in a pull request diff?▼

Code diff simplification identifies smaller, behavior-preserving changes by locating confirmed opportunities to remove unnecessary complexity like dead code, redundant logic, and speculative abstractions. It requires diff-scope inspection to produce evidence-based verdicts with proof and verification steps.

How do I reduce risky churn and simplify refactoring changes before review?▼

To reduce risky churn in refactoring changes, locate confirmed opportunities to remove unnecessary complexity across single or multiple file clusters. Produce evidence-gated recommendations that clearly answer what to change, why it is lower risk, and what verification to run before deeper review.

Can I automatically apply behavior-preserving simplifications to a local diff?▼

Yes, you can automatically apply behavior-preserving simplifications to a local diff by running the process with the --auto flag. This applies only confirmed, safe changes that remove unnecessary complexity without altering the original software behavior.

Does diff simplification work effectively on large multi-file code changes?▼

Diff simplification works on large multi-file code changes by dispatching a focused simplifier approach for larger or multi-area changes. It uses scope-aware rules to inspect the actual changed code rather than just summaries, choosing direct inspection for smaller diffs for efficiency.

What is the best way to verify that a code simplification is behavior-preserving?▼

The best way to verify a code simplification is behavior-preserving is to use evidence-gated recommendations that require clear proof for each finding. Each verdict must answer what local pattern proves it and what specific verification steps to run before applying the change.