polish

Runs deduplication and prose-tending passes over a branch's diff and commits the results.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/vzakharov/vovazakharov.com --skill polish-vzakharov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polish
Source: https://github.com/vzakharov/vovazakharov.com/tree/main/.claude/skills/polish
Command: npx skills add https://github.com/vzakharov/vovazakharov.com --skill polish-vzakharov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Work that never went through the standard /go workflow misses the quality passes that catch duplication and prose defects, and repeated reviews waste effort re-reading code that was already cleared. ## Core Features & Use Cases - Two ordered quality passes: Runs /dry to remove duplication surfaced by new code, then /tend-prose to fix prose defects, in a load-bearing order so prose is reviewed only after code settles. - Branch-scoped review with a floor: Resolves the diff against the fetched base branch and narrows it to changes since the last polish: commit, so repeat runs only review new work. - Auditable empty runs: Commits even when nothing changes, leaving a polish: nothing to change marker that becomes the floor for the next run. - Use Case: After finishing a feature branch outside the /go workflow, invoke /polish to review everything the branch changed since its base, then run /polish full later if review standards have moved and the whole diff needs re-reading. ## Quick Start Ask the assistant to polish this branch, optionally passing focus guidance or the word full to re-read the entire diff against the base branch.

Frequently Asked Questions about polish

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run code quality passes on a branch after implementation?

Invoke /polish with optional focus guidance to run the /dry deduplication pass followed by the /tend-prose pass over the branch's diff. Each pass commits its own edits, and the run pushes so the commits are visible remotely.

How do I re-review an entire branch diff instead of just recent changes?

Run /polish full to ignore the last polish commit and re-read the whole diff against the base branch. This is the override for cases where a previous run stopped early or review standards have since changed.

Why does the polish skill fetch the base branch before diffing?

The fetch is mandatory because a stale origin/<base> ref silently widens the diff range to include commits the base landed since the clone. Without it, the passes would review other people's merged work as if the branch had written it.

What happens when a polish run finds nothing to change?

The run still creates an empty commit with the subject 'polish: nothing to change'. This marker becomes the floor for the next run, so subsequent invocations only review work done after that point.

When should I not use the polish skill?

Do not use it to run the vet suite, modify pull requests, or perform general refactoring of code the branch did not touch. Both passes are scoped strictly to the branch's own changes, and skipping either pass means the skill was not run.