polish

Iteratively fixes failing tests and quality criteria through fix-test-review loops.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/DoctorMozg/claude-pipelines --skill polish-doctormozg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polish
Source: https://github.com/DoctorMozg/claude-pipelines/tree/main/plugins/mz-dev-pipe/skills/polish
Command: npx skills add https://github.com/DoctorMozg/claude-pipelines --skill polish-doctormozg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Existing code often fails tests, lint checks, or quality gates, and manually cycling through fix-run-review is slow and error-prone. This Skill orchestrates an iterative pipeline that assesses failures, applies fixes, and verifies every completion criterion before finishing. ## Core Features & Use Cases - Criteria-driven fix loop: Parses completion criteria into a checklist, triages failures by complexity, and runs up to 5 fix-test-review iterations with code review gates. - TDD lane for uncovered behavior: Writes a failing regression test first for behavioral criteria lacking test coverage, then fixes the code against it. - Optimization and final verification: Removes dead code and debug artifacts, runs an over-engineering review, and confirms all criteria pass. - Use Case: After a refactor leaves 12 failing tests and lint errors, run polish with the criteria "all tests pass and pre-commit is clean" and let the pipeline fix, review, and verify until green. ## Quick Start Ask the AI to polish the current branch so that all failing tests pass and the pre-commit hooks run clean.

Frequently Asked Questions about polish

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

FAQPage Schema
How do I fix all failing tests in a project automatically?

Run the polish pipeline with criteria like "all tests in test_foo.py must pass". It assesses failures, applies quick fixes, dispatches coder agents for complex issues, and loops through fix-test-review cycles until every criterion passes.

What is the difference between polish, build, and debug workflows?

Polish iterates on existing code to meet quality criteria. Use build for new features from scratch, debug for a single isolated bug with a known reproducer, and polish when code exists but fails tests, lint, or quality gates.

Can I restrict which files the polishing pipeline may edit?

Yes, the scope parameter (branch, global, or working) controls which files agents may edit. Tests and linters still run on the full project; scope only limits where fixes are applied, and out-of-scope edits are reported as blockers.

What happens when a behavioral requirement has no test coverage?

The pipeline marks it uncovered and enters a TDD lane: a test-writer agent creates a regression test that fails against current code, verifies it fails, then the fix must turn it green without modifying the test.

What happens if fixes keep failing after several iterations?

After 5 fix iterations or 3 failed reviews, the pipeline escalates to the user with the failing criteria, latest error output, and a summary of what was tried, asking for guidance or missing context.