skills.rest
gerald-ica
gerald-icaCOMMUNITY
Explore all skills by this author →
GitHub

pr-automation

Automate GitHub PR review and merge lifecycle with a state-machine workflow.

Updated Apr 14, 2026
Search Tags:#automation#workflow#github#merge#ci#pull-request#pr-automation
One-click install
npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill pr-automation-gerald-ica
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-automation
Source: https://github.com/gerald-ica/opencode-config-snapshot/tree/main/opencode/skills/pr-automation
Command: npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill pr-automation-gerald-ica

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

PR Automation Orchestrator handles the tedious manual tasks of triaging PRs, running CI checks, and orchestrating reviews and merges, freeing teams to focus on value-driven work.

Core Features & Use Cases

  • State-machine PR processing: polls open PRs, claims them with mutex labels, and advances through review or fix cycles.
  • CI-aware workflow: triggers, monitors, and responds to CI results, including retries and human handoffs.
  • Deterministic session execution: performs at most one heavy action per invocation to ensure safety and traceability. Use Case: A team wants to automate routine PR triage and auto-merge eligible PRs after successful checks while surfacing issues for human review.

Quick Start

Invoke the skill with /pr-automation to start an automation cycle managed by scripts/pr-automation.sh.

Frequently Asked Questions about pr-automation

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

FAQPage Schema
How do I automate GitHub PR review and merge workflows?▼

To automate GitHub PR review and merge workflows, you can use a state-machine orchestrator that polls open PRs, claims them with mutex labels, runs automated reviews, handles fixes, performs CI checks, and escalates to human review when necessary.

What is a state-machine workflow for pull request automation?▼

A state-machine workflow for pull request automation manages the end-to-end PR lifecycle by claiming PRs with mutex labels, advancing through review or fix cycles, and ensuring a single heavy action per invocation for safe, deterministic progress with proper cleanup.

Does PR automation support CI-aware checks and human handoffs?▼

Yes, CI-aware PR automation triggers, monitors, and responds to CI results, including retries and human handoffs, ensuring eligible PRs are auto-merged after successful checks while surfacing issues for human review.

How to handle PR triage and auto-merge eligible pull requests after CI passes?▼

Handle PR triage and auto-merge by polling open PRs and applying a state-machine workflow that claims PRs, runs automated reviews, performs CI checks, and auto-merges eligible PRs after successful checks while escalating issues for human review.

What are the limitations of deterministic session execution in PR automation?▼

The limitation of deterministic session execution in PR automation is that it performs at most one heavy action per invocation to ensure safety and traceability, meaning multiple PRs require multiple automation cycles to process.

Related Skills

Explore More Software Engineering Skills→
JuanMS20JuanMS20

github-auth

Configure GitHub authentication for Hermes Agent using git, gh CLI, or SSH credentials.

Community
Intermediate
pwnk77pwnk77
59

Progress Tracker

Track task completion and generate automated project status reports.

Community
Intermediate
Sir-chawakornSir-chawakorn
33

pr-review

Automate Pull Request reviews for code quality, security, and performance.

Community
Advanced
HabibTorjmenHabibTorjmen

merge-train-infra

Document GitHub Actions automation internals for merge-train operations.

Community
Advanced