# Simplify

> Review changed code on the current branch for reuse, clarity, and dead complexity, then propose or apply minimal cleanup without changing behavior.

- Skill: `s-hiraoku/simplify` (Agent Skill)
- Install (CLI): `npx skillmds@latest add s-hiraoku/simplify`
- Raw SKILL.md: https://api.skillmd.com/api/skills/s-hiraoku/simplify/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: s-hiraoku (https://skillmd.com/u/s-hiraoku)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/s-hiraoku/simplify

---


# Simplify

Use this workflow after a feature is functionally complete but before review or merge, to remove avoidable complexity introduced during implementation.

## Workflow

1. List changed files: `git diff origin/main...HEAD --stat` and `git diff origin/main...HEAD --name-only`.
2. For each meaningful file, ask:
   - Is there an existing helper, type, or constant in the codebase that does this already? Search before adding.
   - Are there abstractions or layers that the change does not actually need yet?
   - Is there error handling for cases that cannot occur?
   - Are there comments restating what the code already says?
   - Are there unused variables, imports, or branches?
3. Apply minimal, behavior-preserving cleanups. Do not rewrite working code for stylistic reasons.
4. Re-run targeted tests for each touched module to confirm behavior is unchanged.

## Constraints

- Never introduce new abstractions during simplify — that is a separate refactor task.
- Preserve public APIs and observable behavior exactly.
- If a cleanup is risky, propose it in the final report instead of applying it.

## Final Report

Include:

- files cleaned up
- specific reductions (lines removed, helpers reused)
- tests run and result
- proposals not applied (with reasoning)