skills.rest
dsifry
dsifryCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

pr-shepherd

Monitor GitHub pull requests and resolve CI failures until merge.

7|Updated Dec 2, 2025
Search Tags:#automation#ci/cd#monitoring#pull request#developer workflow#github#agent
One-click install
npx skills add https://github.com/dsifry/glove80-keymap-visualizer --skill pr-shepherd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-shepherd
Source: https://github.com/dsifry/glove80-keymap-visualizer/tree/main/.claude/plugins/glove80-viz/skills/pr-shepherd
Command: npx skills add https://github.com/dsifry/glove80-keymap-visualizer --skill pr-shepherd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the tedious and time-consuming process of monitoring a Pull Request from creation to merge. It handles CI failures, review comments, and minor fixes autonomously, freeing you from constant vigilance and allowing you to focus on new development.

Core Features & Use Cases

  • Autonomous Monitoring: Continuously checks CI/CD status and new review comments in the background.
  • Self-Correction: Automatically fixes simple issues like linting, formatting, and type errors, and delegates complex review handling to the handling-pr-comments skill.
  • Intelligent Escalation: For complex issues, it transitions to a WAITING_FOR_USER state, presenting clear options and recommendations for your decision.
  • Use Case: Once you've created a Pull Request, activate the pr-shepherd skill. It will take over, monitoring the PR, addressing feedback, and making necessary fixes until all checks pass and all threads are resolved, reporting back only when your input is truly needed or the PR is ready to merge.

Quick Start

Activate the pr-shepherd skill to monitor the current pull request until it merges.

Frequently Asked Questions about pr-shepherd

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

FAQPage Schema
How do I automate monitoring and merging pull requests on GitHub?▼

Automate PR monitoring by activating pr-shepherd, which continuously checks CI status, review comments, and thread resolution in the background every 60 seconds until all checks pass and the PR merges automatically.

Can pr-shepherd fix CI failures and linting errors automatically?▼

Yes, pr-shepherd handles simple issues like linting, formatting, and type errors autonomously, while delegating complex review feedback to specialized handling and escalating ambiguous issues to you for decision.

What happens when pr-shepherd encounters review comments it can't resolve?▼

For complex or unresolved review threads, pr-shepherd transitions to a WAITING_FOR_USER state, presenting clear options and recommendations so you decide next steps before continuing.

Does pr-shepherd work with existing GitHub CI/CD workflows?▼

Yes, pr-shepherd integrates with GitHub pull requests and monitors CI/CD status alongside review comments, handling failures and thread resolution within your current workflow automatically.

When should I use pr-shepherd instead of manual PR management?▼

Use pr-shepherd when you want to eliminate constant vigilance on PRs after creation, freeing you to focus on new development while it handles monitoring, fixes, and escalation until merge-ready.

Related Skills

Explore More Software Engineering Skills→
zach-sourcezach-source

ci-polling

Monitor GitHub Actions and GitLab CI/CD pipeline statuses with background polling tasks.

Community
Intermediate
pulsemcppulsemcp

perform-release

Trigger production deployment workflows and monitor ECS rollout health.

Official
Advanced
jpeggdevjpeggdev

handling-pr-comments

Fetch and resolve pull request review comments with GitHub CLI and jq.

Community
Advanced
antigravityos187-sketchantigravityos187-sketch

pr-loop

Automate PR review and repair with iterative bot triage and verification.

Community
Advanced