Code Polish

This is a two-stage pipeline that runs code-simplify then code-review with auto-fix on your recent changes. The smart part is scope resolution: it figures out what "polish this" means once, whether that's session-modified files, uncommitted changes, or an explicit list, then feeds the same file list to both passes so you're not answering the same question twice. You get one combined report covering simplifications, review findings, fixes applied, and verification results. It skips the usual simplify verification step since review runs afterward anyway. Useful when you want a full cleanup pass without babysitting two separate tools or reconciling overlapping diffs.

skills.sh installs: 2.8K
GitHub stars: 104
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add paulrberg/agent-skills --skill code-polish --agent claude-code

Installs into .claude/skills of the current project.

Files

Code Polish

Resolve scope once. Make only high-confidence simplifications. Fix defects supported by evidence according to their risk. Verify the final state.

Modes

--simplify: simplify only.
--review: review and fix only.
Neither or both: simplify, then review the simplified result.
--with-profile <name> / --skip-profile <name>: add or suppress review profiles. Skip wins.

Fixed Scope

Require a Git repository.
Use explicit paths, patterns, ranges, natural-language targets, or a supplied resolved-scope block when present. Otherwise, use only files modified in this session. If session history is unavailable, use all uncommitted tracked and untracked files.
Exclude lockfiles, generated outputs, vendored code, minified bundles, and large data snapshots from manual review unless explicitly requested. Validate relevant excluded outputs through their generator, schema, or invariants.
Resolve and retain one authoritative scope set and optional exclusions for execution. Do not broaden or recompute scope later. Stop if it is empty.