PR Review and Draft
Review code changes for correctness, performance, security, and test completeness, then draft a structured PR summary.
DocumentationRequirements & limits
Use when code changes need correctness, performance, security, and test review plus a structured PR draft.
Inputs
- diff or changed file list
- verification results if available
- test or coverage context
Outputs
- Review findings
- Risk summary
- PR draft
Before you begin
- Reading and copying the procedure require no terminal setup. Check requirements for any packaged programs separately.
Try this first
Read the procedure and supply its documented inputs. Use the full text in an agent app or chat that supports pasted instructions, following that host's guidance.
Limits for this step
- Instruction package only; it does not provide or authorize an executable runtime capability.
- Safe for review and drafting; require human approval before applying code changes based on review findings.
Read full instructionsHide full instructions
PR Review and Draft
When to use
- Use when a branch or diff is ready for review.
- Use when you need a deterministic PR summary.
- Use when a reviewer wants a focused risk assessment.
Inputs required
- diff or changed file list
- verification results if available
- test or coverage context
Workflow
- Review the diff using the rubric for correctness, performance, security, and tests.
- Capture concrete findings with evidence.
- Summarize validation already completed and what remains.
- Draft the PR summary with intent, impact, and risk.
Output format
- Findings
- Open Questions
- Verification Status
- PR Summary
- Risk Notes
Guardrails
- Prioritize bugs and regressions over style comments.
- Do not claim security or performance review without evidence.
- Keep PR summaries grounded in the actual diff.
- Escalate if the diff affects protected paths or production policy.
Failure modes
- If the diff is incomplete, say which context is missing.
- If no verification is available, mark review confidence as reduced.
- If the change is too broad, recommend splitting the PR.
View file metadata
---
name: pr-review-and-draft
description: Review a code diff from multiple perspectives and produce a
concise PR draft with risks, validation, and follow-up notes.
---Install instruction files
These commands copy guidance into the selected runtime directories. Confirm that your agent app discovers it. Any packaged programs need separate setup and verification.
Install (Codex)
./bin/skills-hub install engineering/[email protected] --runtime codex
Install (Claude)
./bin/skills-hub install engineering/[email protected] --runtime claude
Install (Generic)
./bin/skills-hub install engineering/[email protected] --runtime generic --target ./my-agent/skills