code-simplification

SKILL.md

Code Simplification

Inspired by the Claude Code Simplifier plugin. Adapted here as a model-agnostic, process-driven skill for any AI coding agent.

Overview

Simplify code by reducing complexity while preserving exact behavior. The goal is not fewer lines — it's code that is easier to read, understand, modify, and debug. Every simplification must pass a simple test: "Would a new team member understand this faster than the original?"

When to Use

After a feature is working and tests pass, but the implementation feels heavier than it needs to be

During code review when readability or complexity issues are flagged

When you encounter deeply nested logic, long functions, or unclear names

When refactoring code written under time pressure

When consolidating related logic scattered across files

After merging changes that introduced duplication or inconsistency

When NOT to use: