code-polish

Installation
SKILL.md

Code Polish

Objective

Polish recently changed code in one run: simplify for readability and maintainability, then run an exhaustive risk-profiled review that applies fixes autonomously. Resolve scope once, prioritize correctness/security/data-integrity over style, and produce one user-facing report. Run either pass alone with --simplify or --review.

Modes

Passes are selected by flags and default to running both, in this fixed order:

  • --simplify only: run the Simplify Pass, then verify and report.
  • --review only: run the Review Pass (always applies fixes), then verify and report.
  • neither flag, or both flags: run the Simplify Pass, then the Review Pass, over one resolved scope.

When both run, the review pass sees the simplified code: reuse file contents already loaded during simplify and only re-read files the simplify pass changed.

Arguments

Installs
1.9K
GitHub Stars
64
First Seen
Feb 11, 2026
code-polish — paulrberg/agent-skills