pr-shepherding

Monitor PR lifecycle from creation through merge including CI monitoring, review comment handling, thread resolution, and merge readiness verification.

509 stars

bya5c-ai

View on GitHub Installation ↓

Best use case

pr-shepherding is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Monitor PR lifecycle from creation through merge including CI monitoring, review comment handling, thread resolution, and merge readiness verification.

Teams using pr-shepherding should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/pr-shepherding/SKILL.md --create-dirs "https://raw.githubusercontent.com/a5c-ai/babysitter/main/library/methodologies/metaswarm/skills/pr-shepherding/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/pr-shepherding/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How pr-shepherding Compares

Feature / Agent	pr-shepherding	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Monitor PR lifecycle from creation through merge including CI monitoring, review comment handling, thread resolution, and merge readiness verification.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# PR Shepherding

## Overview

Monitor and manage a PR from creation through merge. Handle CI failures, respond to review comments, resolve threads, and verify merge readiness.

## When to Use

- After PR creation from completed work
- When a PR needs CI monitoring
- When review comments need automated handling

## Process

1. **Monitor CI** - Watch pipeline status, triage failures
2. **Handle Comments** - Respond to review feedback, make code changes
3. **Resolve Threads** - Close addressed review threads
4. **Verify Readiness** - Check approvals, CI green, threads resolved, coverage met

## Merge Readiness Checklist (gtg)

- [ ] All CI checks passing
- [ ] Required approvals obtained
- [ ] All review threads resolved
- [ ] Coverage thresholds met
- [ ] No merge conflicts
- [ ] SERVICE-INVENTORY.md updated

## Agents Used

- `agents/pr-shepherd/` - PR lifecycle management

## Tool Use

Invoke via babysitter process: `methodologies/metaswarm/metaswarm-pr-shepherd`

Related Skills

process-builder

509

from a5c-ai/babysitter

Scaffold new babysitter process definitions following SDK patterns, proper structure, and best practices. Guides the 3-phase workflow from research to implementation.

Workflow & Productivity

babysitter

509

from a5c-ai/babysitter

Orchestrate via @babysitter. Use this skill when asked to babysit a run, orchestrate a process or whenever it is called explicitly. (babysit, babysitter, orchestrate, orchestrate a run, workflow, etc.)