skills.rest
jankneumann
jankneumannCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

simplify

Review code diffs for behavior-preserving refactors like dead code removal.

Updated Apr 12, 2026
Search Tags:#diff analysis#code review#refactoring#maintainability#simplification#behavior preservation
One-click install
npx skills add https://github.com/jankneumann/agentic-assistant --skill simplify-jankneumann
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: simplify
Source: https://github.com/jankneumann/agentic-assistant/tree/main/.agents/skills/simplify
Command: npx skills add https://github.com/jankneumann/agentic-assistant --skill simplify-jankneumann

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simplify code diffs by removing unnecessary complexity and improving clarity without changing behavior, reducing long-term maintenance risk.

Core Features & Use Cases

  • Behavior-preserving simplifications: Reviews diffs to identify dead code, deep nesting, long functions, premature abstractions, and unclear naming that can be improved safely.
  • Chesterton's Fence gating: Applies a pre-change checklist (why it exists, what problem it solves, and which invariants it preserves) before proposing or applying any non-trivial edits.
  • Rule of 500 guardrails: Prevents large manual simplifications by enforcing size/file-count limits and recommending automation or splitting when thresholds are exceeded.

Quick Start

Ask the AI to review a specific changed file or module and apply only low-risk simplifications that preserve behavior exactly.

Frequently Asked Questions about simplify

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

FAQPage Schema
How do I simplify code in a pull request without changing runtime behavior?▼

Behavior-preserving refactors simplify code by removing dead code, reducing nesting, and improving naming while strictly preserving public APIs, test assertions, and runtime behavior to reduce long-term maintenance risk.

What is Chesterton's Fence in code review and refactoring?▼

Chesterton's Fence in refactoring is a pre-change checklist that requires documenting why code exists, what problem it solves, and which invariants it preserves before applying any non-trivial simplification edits.

How do I safely reduce deep nesting and extract long functions?▼

Safely reduce deep nesting and extract long functions by reviewing diffs for behavior-preserving refactors that focus on reuse and quality, ensuring the edits maintain exact runtime behavior and public API contracts.

What are the size limits for manual code simplification?▼

The Rule of 500 constrains manual code simplification by enforcing size and file-count limits, recommending automation or splitting workflows when refactoring thresholds are exceeded to ensure safe changes.

When should I avoid refactoring dead code in a diff?▼

Avoid refactoring dead code in a diff if it fails the Chesterton's Fence check, meaning you cannot clearly identify why the code exists, what problem it solves, or which invariants it preserves before editing.

Related Skills

Explore More Software Engineering Skills→
kaiohenricunhakaiohenricunha

code-simplifier

Simplify changed code in pull requests or branch diffs without altering behavior.

Community
Intermediate
RheasilviaRheasilvia

test-driven-development

Enforce the Red-Green-Refactor cycle with automated tests via terminal.

Community
Advanced
act70255act70255

code-reviewer

Automate code reviews with static analysis and AI vulnerability detection.

Community
Advanced
mishahaninmishahanin
10

ast-grep

Translate natural language queries into structural AST patterns for code search.

Community
Advanced