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.