mergify-merge-queue

Diagnose and manage Mergify merge queue PRs using CLI commands and GitHub surfaces.

32|11|Updated May 17, 2021
One-click install
npx skills add https://github.com/Mergifyio/mergify-cli --skill mergify-merge-queue-mergifyio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mergify-merge-queue
Source: https://github.com/Mergifyio/mergify-cli/tree/main/skills/mergify-merge-queue
Command: npx skills add https://github.com/Mergifyio/mergify-cli --skill mergify-merge-queue-mergifyio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a pull request disappears from the Mergify merge queue or fails to merge, developers struggle to determine whether it was dequeued, merged, or never queued, and why. This Skill provides a systematic workflow to queue, dequeue, monitor, and diagnose PRs in the Mergify merge queue. ## Core Features & Use Cases - Queue Management: Queue or dequeue PRs via @mergifyio queue and @mergifyio dequeue comments, and pause or unpause the entire queue with a required reason. - Dequeue Diagnosis: Use mergify queue show <PR> to get the dequeue code, failing check names, and direct CI job-log URLs, with fallbacks to the Mergify activity log API, the Mergify Merge Queue check run, and the # Merge Queue Status bot comment. - Reason-to-Action Mapping: A complete table of dequeue codes (CHECKS_FAILED, CHECKS_TIMEOUT, CONFLICT_WITH_BASE_BRANCH, etc.) with the exact remediation for each. - Use Case: A developer's PR vanished from the queue overnight. Run mergify queue show 1234 to learn it was dequeued with CHECKS_FAILED, follow the failing job-log link, fix the CI issue, and requeue with a comment. ## Quick Start Ask the assistant to check why PR 1234 left the merge queue using the mergify queue show command and explain what to do next.

Frequently Asked Questions about mergify-merge-queue

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

FAQPage Schema
How do I queue a pull request with Mergify?

Post the comment `@mergifyio queue` on the pull request; Mergify acknowledges it with a thumbs-up reaction. To remove it, comment `@mergifyio dequeue`. There is no CLI subcommand for queuing or dequeuing individual PRs.

How do I find out why my PR was dequeued from the merge queue?

Run `mergify queue show <PR_NUMBER>`; it prints the dequeue code, the reason, and failing checks with direct CI job-log URLs. If the CLI cannot read the activity log, fall back to the Mergify Merge Queue check run or the `# Merge Queue Status` bot comment.

What does CHECKS_FAILED mean in the Mergify merge queue?

CHECKS_FAILED means required checks failed on the temporary merge commit the queue created. Read the failing check's details_url to open the CI job log, fix the failure, then requeue with `@mergifyio queue`; flaky failures can be requeued as-is.

Why does mergify queue show say my PR is not in the merge queue?

That notice means no queue activity exists in the retained 90-day window: the PR was never queued, its events aged out, or the number is wrong. Confirm the PR exists with `gh pr view` before concluding it was never queued.

How do I pause the Mergify merge queue during an incident?

Run `mergify queue pause --reason "your reason"` to halt new merges; running CI is not cancelled. Resume with `mergify queue unpause`, and use `--yes-i-am-sure` to skip confirmation in scripts.

How far back does Mergify merge queue history go?

The activity log retains 90 days of events, and API queries cannot span more than 93 days. Always pass `received_from` when querying the logs endpoint directly, since the default window is only the last 24 hours.