code-simplify — Claude Code skill: what it does, install
The code-simplify skill simplifies existing code without changing its behavior. Use it for a focused cleanup when the user explicitly asks for less complexity.
no license 186 installs ★ 5 updated 2026-08-31
npx skills add ulpi-io/skills --skill code-simplify -a claude-codeWhat code-simplify does
The skill reads the target, nearby callers, and relevant tests before editing. It establishes a useful check, then works through small readability changes: dead-code removal, boolean cleanup, flatter control flow, less duplication, local renames, and narrowly scoped helper extraction.
Checks run again after each edit. A change that affects observable behavior or causes a regression is reverted, while safe improvements remain. The skill is not for bug fixes, performance tuning, architecture redesign, or generated files. It runs only after an explicit request to simplify or clean up existing code.
What it helps with
- flatten nested conditionals safely
- remove dead branches and unused code
- reduce duplication in local logic
- rename unclear local symbols
- verify cleanup without changing behavior
Example prompts for the agent
- Simplify this file while preserving behavior and error handling.
- Clean up
auth.ts, then inspect its callers and tests. - Reduce complexity in this section with guard clauses, without changing the public contract.
How to install code-simplify
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill code-simplify -a claude-code2Manually: put the files in place
~/.claude/skills/code-simplify/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/code-simplify/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill code-simplify -a codex2Manually: put the files in place
.agents/skills/code-simplify/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill code-simplify -a cursor2Manually: put the files in place
.cursor/skills/code-simplify/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ulpi-io/skills code-simplify2Manually: put the files in place
.github/skills/code-simplify/SKILL.md1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill code-simplify -a gemini-cli2Platform CLI
gemini skills install https://github.com/ulpi-io/skills --path code-simplifyManually: put the files in place
.devin/skills/code-simplify/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill code-simplify -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about code-simplify
How do I install code-simplify in Claude Code?
Run npx skills add ulpi-io/skills --skill code-simplify -a claude-code, then use ~/.claude/skills/code-simplify/SKILL.md.
What does code-simplify do?
It applies small readability-focused edits to existing code while preserving behavior. The skill checks the baseline before editing and verifies it again after each change.
Does code-simplify run during unrelated work?
No. It is intended for explicit requests to simplify or clean up code, not for fixing defects, tuning performance, redesigning architecture, or editing generated files.