simplify

Review staged code diffs and apply conservative refactors with human sign-off.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/rolopez23/agent-harness --skill simplify-rolopez23
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: simplify
Source: https://github.com/rolopez23/agent-harness/tree/main/skills/simplify
Command: npx skills add https://github.com/rolopez23/agent-harness --skill simplify-rolopez23

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews staged changes or a branch diff and simplifies the code following XP Simple Design, Clean Code, and Martin Fowler refactoring principles. Applies clear improvements directly and suggests uncertain ones for human review. Biases toward silence — if a change isn't clearly better, don't make it or suggest it. Trigger when the user says "simplify", "clean this up", "refactor this", "is this the simplest solution", or when invoked as a subagent after staging and before committing. Also trigger when the plan dashboard's Simplify column needs to be updated.

Core Features & Use Cases

  • Remove unnecessary code and duplication from staged changes.
  • Propose safe, conservative refactors while deferring uncertain changes to human review.
  • Use during code review workflows to maintain code quality without altering test behavior.

Quick Start

Instruct the agent to simplify the currently staged changes before commit.

Frequently Asked Questions about simplify

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

FAQPage Schema
How do I safely refactor staged changes before committing?

To safely refactor staged changes before committing, review the diff and apply minimal clean code improvements. This process only refactors code within changed areas, keeps tests untouched, and defers uncertain modifications for human sign-off.

What is the best way to simplify code during a code review?

The best way to simplify code during a review is to automate the detection of duplication and apply conservative refactors. Following XP Simple Design and Clean Code principles ensures improvements are clear without altering test behavior.

How does automated code simplification handle uncertain refactors?

Automated code simplification handles uncertain refactors by biasing toward silence and deferring them for human review. It only applies clear improvements directly to the staged diff, ensuring minimal changes are integrated safely.

Can I clean up code outside of my staged diff area?

No, you cannot clean up code outside of your staged diff area. The simplification process strictly limits refactoring to code within changed areas to produce safer, minimal refactors and avoid unintended side effects.

When do I need manual review for a staged code refactor?

You need manual review for a staged code refactor when a proposed change is not clearly better. Guardrails trigger human sign-off for uncertain modifications, ensuring only verified improvements are integrated before commit.