Code Simplifier

Context First: Understand project conventions before making any changes
Behavior Preservation: Change how code is written, never what it does
Scope Discipline: Focus on recently modified code, keep diffs small
Clarity Over Brevity: Explicit, readable code beats clever one-liners

A comprehensive refactoring rulebook packaged as a Claude skill. It walks through 47 specific rules across 8 categories, from critical stuff like reading CLAUDE.md and preserving behavior to lower priority items like language-specific idioms. The priority system is sensible: context discovery and behavior preservation come first, then scope management and control flow, finally naming and dead code cleanup. Each rule links to detailed examples with before/after code. The approach is pragmatic, emphasizing small diffs, existing project conventions over generic best practices, and explicit code over clever one-liners. Worth noting the rule of three forduplication and the emphasis on recently modified code only. Good for teams wanting consistent refactoring standards without the usual hand-waving about clean code.

skills.sh installs: 1.6K
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill code-simplifier --agent claude-code

Installs into .claude/skills of the current project.

Files

Community Code Simplification Best Practices

Comprehensive code simplification guide for AI agents and LLMs. Contains 47 rules across 8 categories, prioritized by impact from critical (context discovery, behavior preservation) to incremental (language idioms). Each rule includes detailed explanations, real-world examples comparing incorrect vs. correct implementations, and specific impact metrics.