pr-handoff
Automates the final PR handoff process, including status updates and reviewer assignment, once a PR is approved.
Install
mkdir -p .claude/skills/pr-handoff && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/17800" && unzip -o skill.zip -d .claude/skills/pr-handoff && rm skill.zipInstalls to .claude/skills/pr-handoff
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
reviewer-agent invoca após verdict APPROVED. Marca PR ready-for-review, posta sumário, atribui CEO como reviewer. Implementa SPEC §3 passo 10.Key capabilities
- →Marks a pull request as ready-for-review.
- →Posts a summary comment to the pull request.
- →Assigns the CEO as a reviewer for the pull request.
- →Signals completion to the cto-agent for traceability updates.
How it works
The skill verifies pre-conditions like an APPROVED verdict and a contract score of at least 0.70. It then uses `gh pr ready` to mark the PR, `gh pr comment` to post a summary, and `gh pr edit` to add the CEO as a reviewer.
Inputs & outputs
When to use pr-handoff
- →Marking an approved PR as ready-for-review
- →Posting a standardized PR approval summary
- →Assigning the CEO to review a ready PR
About this skill
pr-handoff — Skill
Purpose
Materializa SPEC §3 passo 10. Quando reviewer emite verdict APPROVED + contract score ≥0.70 + Gate 3 PASS, sinaliza ao CEO que a PR está pronta pra merge.
Protocol
-
Verify pre-condições:
- verdict é APPROVED
- contract_score ≥ 0.70
- Gate 3 (completion-gate) retornou PASS
- review_file existe em
docs/reviews/Se qualquer uma falha, ABORT — não deve estar invocando essa skill.
-
Mark PR como ready-for-review:
gh pr ready <pr_url> -
Post comment com sumário:
gh pr comment <pr_url> --body "$(cat <<EOF ## ✅ APPROVED — reviewer-agent **Contract score:** <X.XX> **Gate 3 (build+test backend):** ✅ exit 0 **Checklist:** 8/8 categorias OK **OWASP spot check:** <N>/<N> itens relevantes verificados **Review file:** \`<review_file>\` Pronto para merge. CEO: revisar delta dos docs de rastreabilidade (memory-manager vai gerar após seu OK) e mergear. EOF )" -
Request review do CEO:
gh pr edit <pr_url> --add-reviewer OmarCamaHuara -
Signal ao cto-agent: handoff completo, transitar pra rastreabilidade (memory-manager via
traceability-update).
Input contract
- verdict APPROVED (vindo do reviewer-agent)
- review_file existe em
docs/reviews/LKA-NNN-...md - contract_score ≥ 0.70
Output contract
- PR não-draft no GitHub (state: open + ready)
- Comment "✅ APPROVED — reviewer-agent" postado
- @OmarCamaHuara é reviewer atribuído
- Retorna
{ "handed_off": true, "pr_url": "..." }
Error handling
| Situação | Ação |
|---|---|
gh pr ready falha (PR já ready) | OK, continua sem erro |
gh sem perm | Pedir CEO checar gh auth status |
| CEO já é reviewer | Skip add-reviewer, continuar normalmente |
| Network falha | Retry 1×; se falhar 2×, reporta ao reviewer (sem ABORT) |
Quando NÃO invocar esta skill
- Verdict NEEDS_CHANGES ou REJECTED (PR fica draft, devolve ao dev)
- Status
BLOCKED_PENDING_CEO(escalation via cto-agent, NÃO handoff) - Contract score < 0.70 (pre-condição não cumprida)
When not to use it
- →When the verdict is NEEDS_CHANGES or REJECTED.
- →When the status is BLOCKED_PENDING_CEO.
- →When the contract score is less than 0.70.
Limitations
- →Requires the verdict to be APPROVED.
- →Requires a contract score of 0.70 or higher.
- →Requires Gate 3 (completion-gate) to return PASS.
How it compares
This skill automates the final steps of a pull request handover, including status updates and reviewer assignments, which would otherwise require manual execution of multiple commands and checks.
Compared to similar skills
pr-handoff side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| pr-handoff (this skill) | 0 | 29d | Review | Beginner |
| resolve-conflicts | 81 | 8mo | Review | Intermediate |
| dependency-upgrade | 26 | 4mo | Review | Intermediate |
| git-commits | 21 | 3mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
resolve-conflicts
antinomyhq
Use this skill immediately when the user mentions merge conflicts that need to be resolved. Do not attempt to resolve conflicts directly - invoke this skill first. This skill specializes in providing a structured framework for merging imports, tests, lock files (regeneration), configuration files, and handling deleted-but-modified files with backup and analysis.
dependency-upgrade
wshobson
Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use when upgrading framework versions, updating major dependencies, or managing breaking changes in libraries.
git-commits
bonny
Create well-structured git commits in logical chunks following best practices
git-advanced-workflows
wshobson
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.
github-multi-repo
ruvnet
Multi-repository coordination, synchronization, and architecture management with AI swarm orchestration
git-workflow-enforcer
CrazyDubya
Ensures commits follow conventional commits, branch naming conventions, and PR templates. Use when creating commits, branches, or PRs, or when user mentions git workflow.