merge-request

Resolves GitHub pull requests by orchestrating checks, threads, fixes, merges via gh CLI.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/zorgentech/archon --skill merge-request-zorgentech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: merge-request
Source: https://github.com/zorgentech/archon/tree/main/.claude/skills/merge-request
Command: npx skills add https://github.com/zorgentech/archon --skill merge-request-zorgentech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the manual, error-prone process of preparing, validating, and merging GitHub pull requests by orchestrating checks, handling review threads, applying fixes, and performing safe merges.

Core Features & Use Cases

  • Status check orchestration: Detects ADR, visual, CI, and custom checks and invokes follow-up actions or other skills to satisfy them.
  • Review thread processing: Loads unresolved review threads, applies simple fixes in an isolated worktree, replies to reviewers, resolves threads, and creates issues for larger technical debt.
  • Safe merge workflow: Verifies mergeability, approvals, and passing checks, then performs configurable merges (squash/merge/rebase) while cleaning up branches and worktrees.

Quick Start

Resolve pull request #269 by loading its details with the GitHub CLI, addressing pending checks and review comments in an isolated worktree, and merging when all criteria are met.

Frequently Asked Questions about merge-request

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

FAQPage Schema
How do I automate GitHub pull request resolution end-to-end?

Automating GitHub pull request resolution involves orchestrating status checks, processing review threads, applying fixes in an isolated worktree, and performing safe merges. It requires authenticated gh CLI access, permission to push and merge, and adherence to non-destructive merge constraints.

What is the process for handling unresolved review threads on a pull request?

Handling unresolved review threads involves loading the comments, applying simple fixes in an isolated git worktree, replying to reviewers, resolving the threads, and creating separate issues for larger technical debt to ensure safe merges.

Can I use a git worktree to apply fixes for CI checks on GitHub PRs?

Yes, you can use a git worktree to apply fixes for CI checks. The workflow detects ADR, visual, CI, and custom status checks, then invokes follow-up actions and applies isolated edits before verifying mergeability for safe merges.

How do I orchestrate ADR validation and CI checks before a GitHub merge?

Orchestrating ADR validation and CI checks before a GitHub merge requires detecting status checks and invoking follow-up actions to satisfy them. The workflow verifies approvals and passing checks, then performs configurable merges like squash, merge, or rebase.

Do I need authenticated gh CLI access to automate pull request merges?

Yes, authenticated gh CLI access is required to automate pull request merges. You also need a git worktree for isolated edits, permission to push and merge, and adherence to non-destructive merge constraints and CI rerun procedures.

What are the limitations and constraints of a safe merge workflow?

Limitations of a safe merge workflow include strict adherence to non-destructive merge constraints and CI rerun procedures. The process blocks merges unless mergeability, approvals, and passing status checks are fully verified, requiring cleanup of branches and worktrees.