prbuddy

name	prbuddy
description	PR health assistant - monitors CI status, triages review comments, fixes issues with systematic prevention. Triggers on "check my PR", "PR health", "make PR green", "fix PR", "ready to merge", "handle PR feedback".

prbuddy

Overview

prbuddy helps agents monitor PR health by checking CI status and triaging review comments. It fixes immediate issues and implements systematic prevention measures.

Philosophy: "Fix the acute issue AND prevent the class of error from recurring."

Sub-skills:

• prbuddy:ci - CI/workflow monitoring, failure diagnosis, fix + prevent
• prbuddy:reviews - Review comment triage, fix critical, create issues for nitpicks

Prerequisites

Required: gh CLI

Verify gh is installed and authenticated:

gh auth status

If not authenticated, run gh auth login.

Required token scopes:

• repo - Full control of private repositories (for PR operations)
• read:org - Read org membership (for issue creation in org repos)
• workflow - Update GitHub Action workflows (for CI operations)

To check scopes: gh auth status shows granted scopes.

Required: gh-pr-review Extension

This extension is required for review comment handling:

gh extension install agynio/gh-pr-review

Verify installation:

gh pr-review --help

When This Skill Applies

• "check my PR" / "PR status"
• "make this PR green"
• "fix my PR"
• "ready to merge"
• "handle PR feedback"
• "what's blocking my PR"

Workflow

Step 1: Detect PR

gh pr view --json number,title,body,url,headRefName,closingIssuesReferences

If no PR found for current branch, ask user:

• Create a PR: gh pr create
• Specify PR number: /prbuddy 123
• Specify PR URL

Step 2: Check CI Status

gh pr checks --json name,state,bucket,link

If any checks failed: Route to prbuddy:ci

If checks pending: Report status and suggest checkpoint timing:

• "CI is still running. Check again before requesting review or declaring done."

If all checks passed: Continue to reviews

Step 3: Check Review Comments

Route to prbuddy:reviews

Step 4: Report Summary

PR #42 Health Check Complete

CI: ✓ All checks passing
Reviews:
  - 2 critical comments fixed (with prevention)
  - 3 issues created from nitpicks

Ready for: [next action - request review / merge / etc.]

Routing Logic

Keywords → Sub-Skill

prbuddy:ci:

• "CI failing", "workflow failed", "checks red"
• "build broken", "tests failing"
• "check CI status", "rerun workflows"

prbuddy:reviews:

• "review comments", "address feedback"
• "reviewer asked", "changes requested"
• "handle comments", "triage reviews"

prbuddy (full orchestrator):

• "check my PR", "PR health", "make PR green"
• "fix PR", "ready to merge"
• Ambiguous requests

Routing Process

1. Analyze request for keywords
2. If clearly CI-related → prbuddy:ci
3. If clearly reviews-related → prbuddy:reviews
4. Otherwise → Run full orchestrator (CI then reviews)

Error Handling

No PR Found

No PR found for current branch 'feature-xyz'.

Options:
1. Create a PR: gh pr create
2. Specify PR number: /prbuddy 123
3. Specify PR URL: /prbuddy https://github.com/owner/repo/pull/123

gh-pr-review Extension Missing

The gh-pr-review extension is required for review comment handling.

Install it:
  gh extension install agynio/gh-pr-review

Then retry: /prbuddy:reviews

gh Not Authenticated

GitHub CLI is not authenticated.

Run: gh auth login

Then retry: /prbuddy

Fork-Based PRs

This skill assumes write access to the PR branch. For fork-based PRs:

• You may not have push access to the source branch
• Protected branch rules may prevent direct pushes
• Consider creating a fix branch and opening a separate PR

Workaround: Ask the user to push changes manually or grant write access.

Dry-Run Mode

To preview changes without committing, tell the agent:

• "Show me what you would fix, but don't commit"
• "Dry-run mode" or "preview only"

The agent will analyze and report proposed fixes without making changes.