code-simplification
A skill from Addy Osmani's agent-skills collection for making working code easier to read without changing what it does.
What the skill teaches
A skill from Addy Osmani's agent-skills collection for making working code easier to read without changing what it does. Inspired by Claude Code's simplifier plugin but written for any agent, it asks the agent to understand the code first (its callers, tests and history), then look for deep nesting, long functions, nested ternaries, vague names, duplicated or dead code and needless wrappers, and fix them one small step at a time, running tests after each and keeping refactors apart from feature work. Behaviour, errors and edge cases must stay identical and existing tests must pass unchanged. It includes TypeScript, Python and React examples, common excuses with rebuttals, and a final checklist.
Capabilities
- Find nesting, naming and duplication problems in working code
- Refactor in small steps with tests run after each
- Keep behaviour and existing tests unchanged
Install
- Run this to add it to Any client:
npx skills add addyosmani/agent-skills --skill code-simplification
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Code review | |
| Publisher | Addy Osmani | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Cursor, Codex, Gemini CLI, Devin Desktop | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 1, 2026115,373 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Sources
- GitHub repositorygithub.com/addyosmani/agent-skills · Backs: AI clients, Licence, Publisher, ActivityNov 11, 2026
- Skill file (SKILL.md)github.com/addyosmani/agent-skillsNov 10, 2026
- Folder in the repository (code-simplification)github.com/addyosmani/agent-skills · Backs: Includes scriptsNov 10, 2026