code-simplification
Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.
Best for Code reviewsWorks with GitHubLow risk
⌘source
- author
@addyosmani- language
- Shell
★17kstars
2.2kforks
Apr 18, 2026
✦overview.md
Key Features
- ·Simplifies code while preserving exact behavior
- ·Focuses on readability and maintainability over line count
- ·Uses 'new team member' test for simplification decisions
- ·Process-driven approach for any AI coding agent
- ·Model-agnostic implementation
Use Cases
- →After feature completion when implementation feels heavier than needed
- →During code review when readability or complexity issues are flagged
- →When encountering deeply nested logic, long functions, or unclear names
- →When refactoring code written under time pressure
- →When consolidating related logic scattered across files
Best for
- ✓Code reviews
- ✓Refactoring existing codebases
- ✓Team onboarding preparation
Not ideal for
- !Already clean and readable code
- !When you don't understand what the code does yet
name
code-simplification
description
Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.
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:
- Code is already clean and readable — don't simplify for the sake of it
- You don't understand what the code does yet — comprehend before you simplify
$install
1-click copynpx skills add addyosmani/agent-skills --skill code-simplificationSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
3/ 5
mediumPartially actionable with several concrete steps, but still missing important details.