code-simplify

Refactor recently modified code for readability using git diff.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simplify and refine recently modified code to improve clarity, consistency, and maintainability while preserving exact functionality. It helps teams understand changes by removing unnecessary complexity and aligning with project standards.

Core Features & Use Cases

  • Identify recently modified code sections using git diff or git diff --cached.
  • Refactor for readability and maintainability while preserving exact functionality.
  • Enforce project conventions (AGENTS.md/CLAUDE.md) and improve long-term code health.

Quick Start

Review the latest changes and run a refactor pass to improve readability while preserving functionality.

Frequently Asked Questions about code-simplify

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

FAQPage Schema
How do I refactor recent git diff changes for readability without breaking functionality?

Refactor recent git diff changes by identifying modified sections, clarifying logic, reducing complexity, and aligning with project conventions while preserving exact behavior. This improves readability and maintainability without altering what the code does.

What is the best way to simplify code I just committed to improve maintainability?

Simplify recently committed code by running a refactor pass on the modified sections. The process removes unnecessary complexity, enforces project standards, and clarifies logic to improve long-term code health while keeping functionality intact.

Can I use project conventions from AGENTS.md or CLAUDE.md when refactoring code?

Yes, refactoring respects project conventions defined in AGENTS.md or CLAUDE.md files. This ensures the simplified code aligns with existing team standards and maintains consistency across the codebase during the readability improvement process.

How does git diff integration work for identifying code that needs simplification?

Git diff integration identifies recently modified code sections by comparing changes in the working directory or staged area. This targets only the code you recently changed, applying refactoring rules to improve clarity and reduce complexity specifically where updates occurred.

When should I avoid refactoring code for readability?

Avoid refactoring when behavior preservation cannot be guaranteed or when recent changes lack sufficient context. The process focuses on clarifying recent modifications, so large untouched codebases without recent git diff activity will not benefit from this targeted simplification approach.

Does code simplification work on staged changes or only committed code?

Code simplification works on both staged and recently committed changes. By analyzing git diff and git diff --cached, it identifies modified sections in either state, applying refactoring rules to improve readability while preserving exact functionality across both workflows.