sandman-pr-merge

Merge GitHub pull requests when approvals, checks, and tracker conditions pass.

5|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/rafaelromao/sandman --skill sandman-pr-merge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sandman-pr-merge
Source: https://github.com/rafaelromao/sandman/tree/main/internal/skill/sandman/pr-merge
Command: npx skills add https://github.com/rafaelromao/sandman --skill sandman-pr-merge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of merging pull requests in a GitHub repository by automating the checks for approval, mergeability, and required checks before proceeding.

Core Features & Use Cases

  • Conditional Merge: Only merges PRs when all checks are green and the tracker indicates the change request is mergeable.
  • Automated Workflow: Simplifies the PR merge process by automating the steps of confirming approval, checks, and mergeability.
  • Use Case: For teams that want to ensure that only fully approved and properly checked PRs are merged, reducing the risk of merging broken code.

Quick Start

Run the 'sandman pr-merge' command to automatically merge the PR if all conditions are met.

Frequently Asked Questions about sandman-pr-merge

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

FAQPage Schema
How do I automate GitHub pull request merging only when all checks are green?

You can automate GitHub pull request merging by running a command that conditionally merges PRs only when they are fully approved, all required checks are green, and the tracker indicates mergeability. This ensures broken code is never merged.

Can I prevent merging pull requests unless they are fully approved?

Yes, conditional PR merging prevents merging pull requests unless they are fully approved and all required checks pass. It verifies approval, mergeability, and check status before proceeding with the merge.

What do I need to set up before automating PR merge checks in GitHub?

To automate PR merge checks, you need GitHub API access and a properly configured Sandman environment. These prerequisites allow the script to query repository status and execute the conditional merge automatically.

How does conditional PR merging handle required checks and approval status?

Conditional PR merging handles required checks by querying the GitHub API to confirm all checks are green and the PR is fully approved. It also verifies the tracker indicates mergeability before executing the merge command.

When should I not use automated pull request merging?

You should not use automated pull request merging if your repository lacks required status checks or if your environment does not have GitHub API access and a configured Sandman setup, as the merge will fail without proper validation.