Menu
Prepare PRs for review: clean noisy history, improve descriptions, add reviewer guidance. Trigger: 'make easy to review', 'tidy PR', 'clean up commits', 'annotate diff'.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Run objective, repeatable improvement work under an immutable verifier and hard iteration, cost, time, and no-progress limits. Use for approved experiments with an automated metric and sandboxed worker.
Write concise, calm technical responses whose structure matches the decision, evidence, or sequence being communicated. Use when drafting substantial plans, reviews, findings, documentation, or completion summaries.
Operate inside a ControlKeel-governed session. Use this before code edits, shell execution, delegation, deploy work, or any task that needs CK validation, findings, budget, proof, or routing context.
Keep a governed session within budget. Use this before long-running agent work, bulk processing, or any task where spend pressure could change the plan.
Close a governed work session with validation, proof, findings, budget, digest, learning, and handoff checks. Use when the user asks to wrap up, stop for the day, or leave work ready for another agent.
Audit tests that may pass without proving the claimed behavior. Use for periodic test-quality reviews or when coverage looks healthy but regressions still escape.
| name | reviewable-pr |
| description | Prepare PRs for review: clean noisy history, improve descriptions, add reviewer guidance. Trigger: 'make easy to review', 'tidy PR', 'clean up commits', 'annotate diff'. |
| when_to_use | Activate ONLY when explicitly asked to prepare a PR for review. Do NOT auto-trigger during normal coding or review tasks. |
| argument-hint | [PR URL, branch, or current] |
| disable-model-invocation | true |
| license | Apache-2.0 |
| compatibility | ["opencode-native","claude-standalone","cursor-native","codex"] |
| metadata | {"author":"controlkeel","version":"1.1","category":"review","ck_mcp_tools":["ck_git_diff","ck_git_status","ck_validate","ck_review_submit","ck_finding"],"related_skills":["security-review","deep-code-quality-review"]} |
Prepare a PR so a reviewer can quickly understand intent, risk, and key files — without changing code behavior.
ck_git_diff and ck_git_status.ck_validate on the diff. Resolve blocked findings first — reviewability is secondary to correctness.ck_finding (category reviewability, severity medium/low).ck_review_submit (review_type: plan) describing what will change. Wait for approval before rewriting history or force-pushing.ORIGINAL_TREE=$(git rev-parse origin/<branch>^{tree})
# ... rewrite ...
# Tree must match
ck_review_submit approvalck_validate blocked, fix those firstck_finding records for reviewability issuesck_review_submit plan (approved)