om-merge-buddy

Classify open pull requests by merge readiness from reviews, CI, labels, and mergeability.

2.6k|159|Updated Mar 8, 2021
One-click install
npx skills add https://github.com/go-musicfox/go-musicfox --skill om-merge-buddy-go-musicfox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: om-merge-buddy
Source: https://github.com/go-musicfox/go-musicfox/tree/main/.agents/skills/om-merge-buddy
Command: npx skills add https://github.com/go-musicfox/go-musicfox --skill om-merge-buddy-go-musicfox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams with many open pull requests lose track of which ones can actually merge. This Skill scans every open PR, evaluates review approvals, CI checks, merge conflicts, and blocking labels, then reports exactly which PRs are ready to merge, which are almost ready, and which are blocked. ## Core Features & Use Cases - Merge readiness triage: Fetches open PRs via the configured tracker and evaluates gates including review approval, required CI checks, mergeable state, and blocking labels such as changes-requested, qa-failed, blocked, and do-not-merge. - QA gate enforcement: When the qaGate config is enabled, a needs-qa PR without qa-approved is never classified as ready, while skip-qa acts as an explicit opt-out. - Structured report: Produces a three-section Markdown report (Ready to Merge, Almost Ready, Blocked) where every row explains in full sentences which gates pass or fail and what would move the PR forward. - Use Case: Before a release, run the skill to get a read-only inventory showing that PR #123 is mergeable, PR #456 only waits on pending CI, and PR #789 is blocked by conflicts and a changes-requested review. ## Quick Start Ask the agent to run the merge buddy skill and report which open pull requests can merge right now.

Frequently Asked Questions about om-merge-buddy

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

FAQPage Schema
How do I check which pull requests are ready to merge?

Run the skill to scan all open PRs through the configured tracker. It evaluates review approval, required CI checks, merge conflicts, and blocking labels, then reports which PRs are ready, almost ready, or blocked with explanations for each.

What gates decide if a pull request can merge?

The review decision must be APPROVED, required CI checks must be green, mergeable must not be CONFLICTING, and mergeStateStatus must not be DIRTY or BLOCKED. Labels like changes-requested, qa-failed, blocked, do-not-merge, and in-progress are hard blocks.

Does the skill merge pull requests automatically?

No, the skill is strictly read-only. It only classifies and reports merge readiness and never merges, edits, comments on, or labels anything; merging is handed off to the separate om-approve-merge-pr skill.

How does the QA approval gate work for pull requests?

When qaGate is enabled in the config, a PR carrying needs-qa must also carry qa-approved to be classified as ready. A skip-qa label is the explicit opt-out, and when qaGate is disabled the missing QA sign-off is only advisory.

What happens when repository labels are disabled in the config?

When labels.enabled is false, the skill skips all label-based gates and classifies PRs from review decisions, CI checks, and mergeability alone. The report header explicitly notes that label gates were skipped.