Matt Pocock's skill that gives coding agents a shared vocabulary for designing deep modules: interfaces, seams, adapters, depth, leverage and locality, plus rules for testable design.
Code Simplification Skill
Reduces accumulated complexity without changing behaviour, using Chesterton's Fence to avoid deleting the thing that was load-bearing.
Install
Other ways to install
About
- Behaviour-preserving simplification
- Chesterton's Fence guard against deleting load-bearing code
- Targets code that works but is hard to read or extend
- Part of a 24-skill engineering workflow collection
Most codebases do not get complicated by a bad decision; they get complicated by twenty reasonable ones. This skill gives an agent a disciplined way to walk that back: simplify for clarity while preserving exact behaviour, and treat anything you do not understand as load-bearing until you do.
That second half is what makes it usable on real code. Chesterton's Fence is the governing rule — the odd-looking branch, the defensive null check, the retry nobody can explain are not removed because they look unnecessary, they are investigated first. An agent left to its own judgement will happily delete all three and produce a diff that reads beautifully and breaks in production.
Use it when code works but is harder to read, maintain or extend than it should be, or when reviewing something that has silted up over time. It pairs naturally with the collection's code-review skill: one finds the complexity, the other removes it safely.
One of 24 skills in Addy Osmani's agent-skills collection of production engineering workflows for AI coding agents. MIT licensed.
SKILL.md
The instructions your agent loads, as published by Addy Osmani.
Related Skills
See all Code Simplification alternativesMatt Pocock's two-axis code review skill: parallel sub-agents check a diff against the repo's coding standards and against the originating issue or spec, reported side by side.
Addy Osmani's skill for multi-axis code review before merge: correctness, readability, architecture, security and performance, with severity labels, change-size targets, a tests-first review order and a review checklist.
Skill: Doubt-Driven Development
by Addy Osmani
Sends every non-trivial decision to a fresh-context adversarial reviewer before it stands — for production, security-sensitive or irreversible work.