shepherd

Automate pull request lifecycle management with CI/CD status and review synchronization.

2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/evanharmon1/harmon-devkit --skill shepherd-evanharmon1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shepherd
Source: https://github.com/evanharmon1/harmon-devkit/tree/main/ai/skills/universal/shepherd
Command: npx skills add https://github.com/evanharmon1/harmon-devkit --skill shepherd-evanharmon1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, git, and includes assets (resource) components.

What problem does it solve?

This Skill automates the repetitive, multi-round process of shepherding a pull request from draft to ready-for-review, ensuring all CI checks pass and all review findings are systematically addressed.

Core Features & Use Cases

  • Automated PR Gating: Monitors CI/CD status and review threads, enforcing a strict "no findings left behind" policy.
  • Intelligent Adjudication: Tracks and settles inline review comments, distinguishing between new follow-ups, edits, and resolved threads.
  • Use Case: Use this to manage complex PRs where you need to coordinate multiple rounds of CI fixes, bot-generated feedback, and human review comments without manually tracking every thread.

Quick Start

Invoke the shepherd skill by providing the pull request number or URL to begin the automated review and verification loop.

Frequently Asked Questions about shepherd

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

FAQPage Schema
How do I automate pull request review cycles and CI/CD gating on GitHub?

Automate pull request review cycles by synchronizing CI/CD status with human and bot review findings. This Skill operates on GitHub repositories to verify code readiness through iterative rounds of testing, feedback adjudication, and status updates without manual tracking.

How does automated PR adjudication handle inline review comments and CI checks?

Automated PR adjudication tracks and settles inline review comments while monitoring CI/CD status, distinguishing between new follow-ups, edits, and resolved threads. It enforces a strict policy ensuring no review findings are left behind before transitioning PR states.

Do I need the GitHub CLI and local git installed to automate PR lifecycle management?

Yes, automating PR lifecycle management requires the GitHub CLI, local git, and jq installed. These dependencies are necessary to perform authenticated status checks, reply to comments, and execute PR state transitions securely.

Can I use this automated PR gating for complex pull requests with multiple rounds of bot feedback?

Yes, automated PR gating is designed for complex pull requests where you need to coordinate multiple rounds of CI fixes, bot-generated feedback, and human review comments. It systematically manages these iterative loops until all findings are resolved.

What is the best way to ensure no review findings are left behind before a GitHub PR merge?

The best way to ensure no review findings are left behind is to automate the synchronization of CI/CD status and review threads. This enforces a strict gating policy, verifying that all bot and human feedback is systematically addressed before allowing a merge.

Why should I not manually track GitHub PR review threads and CI status updates?

Manually tracking GitHub PR review threads and CI status updates creates bottlenecks in the development lifecycle. Automating this repetitive, multi-round process prevents human error and ensures all feedback is systematically addressed before transitioning PR states.