skills.rest
phrazzld
phrazzldCOMMUNITY
Explore all skills by this author →
GitHub

pr-polish

Review and refine pull requests with code, test, and documentation updates.

13|3|Updated Mar 2, 2026
Search Tags:#testing#quality assurance#code review#documentation#refinement#CI/CD#pr
One-click install
npx skills add https://github.com/phrazzld/agent-skills --skill pr-polish-phrazzld
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-polish
Source: https://github.com/phrazzld/agent-skills/tree/main/core/pr-polish
Command: npx skills add https://github.com/phrazzld/agent-skills --skill pr-polish-phrazzld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the need to refine and improve already functional Pull Requests, ensuring they meet the highest standards of code quality, testing, documentation, and architectural soundness before merging.

Core Features & Use Cases

  • Hindsight Review: Analyzes a PR with the benefit of hindsight to identify potential architectural improvements or simplifications.
  • Code Refinement: Applies clarity and architectural improvements based on review findings.
  • Test Audit & Enhancement: Reviews and adds missing edge-case, error-path, and behavior tests.
  • Merge Confidence Assessment: Explicitly documents evidence and gaps for mergeability.
  • Documentation Updates: Ensures ADRs, READMEs, and diagrams are current.
  • Use Case: After a feature is implemented and passes initial checks, use this Skill to perform a final, rigorous quality pass, ensuring maintainability and robustness.

Quick Start

Run the pr-polish skill on the current PR to ensure it meets exemplary quality standards.

Frequently Asked Questions about pr-polish

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

FAQPage Schema
How do I improve code quality before merging a pull request?▼

To improve code quality before merging a pull request, you can perform a hindsight review and code refinement process. This analyzes the PR to identify architectural improvements and applies clarity enhancements for better maintainability.

What is a hindsight review in software development?▼

A hindsight review is a post-implementation analysis of a working pull request. It evaluates the completed code with the benefit of hindsight to identify potential architectural improvements or simplifications that were not obvious during initial development.

How do I ensure my pull request has adequate test coverage for edge cases?▼

To ensure your pull request has adequate test coverage for edge cases, perform a test audit. This process reviews existing tests and adds missing edge-case, error-path, and behavior tests to strengthen overall coverage.

Does PR refinement update project documentation like ADRs and READMEs?▼

Yes, PR refinement includes updating project documentation. The process ensures that Architecture Decision Records, READMEs, and diagrams are current and accurately reflect the changes introduced by the pull request.

How do I assess merge confidence for a pull request?▼

You assess merge confidence by explicitly documenting evidence and gaps for mergeability. This validates adherence to quality gates and ensures the pull request meets robust standards before final integration.

Related Skills

Explore More Software Engineering Skills→
open-mercatoopen-mercato
1.6k

code-review

Review code changes for architecture, security, and quality compliance.

Official
Advanced
baphledbaphled
1

pre-merge

Execute a pre-merge validation checklist for Pull Requests.

Community
Intermediate
meistro57meistro57
1

laravel:quality-checks

Run automated quality gates for Laravel projects with Pint, PHPStan, and frontend linters.

Community
Intermediate
barichterbarichter

architectural-review

Automate Pull Request reviews for adherence to architectural guidelines.

Community
Advanced