shepherd-to-merge

Manage pull request review, validation, and merge procedures.

1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/photon-grove/skills --skill shepherd-to-merge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shepherd-to-merge
Source: https://github.com/photon-grove/skills/tree/main/skills/shepherd-to-merge
Command: npx skills add https://github.com/photon-grove/skills --skill shepherd-to-merge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the process of shepherding pull requests through review, feedback resolution, CI validation, and auto-merge, reducing manual effort and ensuring compliance with project policies.

Core Features & Use Cases

  • Comprehensive PR Management: Guides users through checking out PR branches, running subagent code reviews, handling feedback, and resolving review threads.
  • Automated Validation: Waits for CI checks, asynchronous reviews, and final verification before enacting auto-merge.
  • Use Case: Developers can use this Skill to efficiently process multiple PRs in sequence, ensuring quality before merging, especially in environments with strict branch protections.

Quick Start

To shepherd a specific PR, specify the repository and PR number or URL, then run the Skill to manage the review, validation, and merge process automatically.

Frequently Asked Questions about shepherd-to-merge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate pull request review and merging?

To automate pull request review and merging, this Skill shepherds PRs by running subagent code reviews, resolving feedback, validating CI checks, and executing auto-merge procedures. This reduces manual effort while ensuring compliance with project policies and branch protections.

How does automated PR management handle CI validation?

Automated PR management handles CI validation by waiting for CI checks and asynchronous reviews to complete. It performs a final verification to ensure all quality standards are met before enacting the auto-merge procedure across multiple pull requests.

Can I process multiple pull requests in sequence automatically?

Yes, you can process multiple pull requests in sequence. This Skill operates across multiple PRs, integrating CI checks and review feedback to ensure high-quality merges while reducing manual developer effort in environments with strict branch protections.

Does automated merging work with strict branch protections?

Yes, automated merging works with strict branch protections. The Skill ensures safety and compliance by conforming to branch protection rules and review requirements before enacting any auto-merge procedures on the target repository.

What is needed to start shepherding a pull request?

To start shepherding a pull request, you need to specify the target repository and the PR number or URL. The Skill then automatically manages the end-to-end review, validation, and merge process for that specific branch.