ralph-merge

Merge approved GitHub pull requests into the main branch and advance issues to Done.

2|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/cdubiel08/ralph-hero --skill ralph-merge-cdubiel08
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-merge
Source: https://github.com/cdubiel08/ralph-hero/tree/main/plugin/ralph-hero/skills/ralph-merge
Command: npx skills add https://github.com/cdubiel08/ralph-hero --skill ralph-merge-cdubiel08

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of merging approved pull requests, cleaning up worktrees, and advancing issues to the 'Done' state, streamlining the final stages of the development workflow.

Core Features & Use Cases

  • Automated Merging: Merges pull requests that are approved and ready.
  • Issue State Management: Moves associated issues to the 'Done' state upon successful merge.
  • Worktree Cleanup: Cleans up the local worktree after merging.
  • Use Case: After a feature is developed, tested, and approved via a pull request, this Skill can be invoked to automatically merge it into the main branch and update the project's issue tracker.

Quick Start

Use the ralph-merge skill to merge pull request number 123 for issue GH-456.

Frequently Asked Questions about ralph-merge

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

FAQPage Schema
How do I automatically merge an approved GitHub pull request into the main branch?

To automatically merge an approved pull request, this Skill validates its mergeability and approval status before integrating it into the main branch and advancing the associated GitHub issue to the 'Done' state.

Can I move a GitHub issue to the Done state automatically after a pull request is merged?

Yes, you can move a GitHub issue to the Done state after a pull request is merged by providing the issue number or PR URL, which identifies the associated PR and updates the workflow state upon successful merge.

What is the best way to merge a pull request and clean up the local worktree?

The best way to merge a pull request and clean up the local worktree is to use an automated workflow that merges the approved PR into the main branch and then removes the associated worktree in a single operation.

How do I merge a pull request for an epic or group worktree issue?

To merge a pull request for an epic or group worktree issue, you provide the issue number or PR URL, and the automation identifies the correct PR from the issue context to merge and advance the issue state.

Does the merge automation check if a pull request is approved before merging?

Yes, the merge automation checks if a pull request is approved by validating PR readiness, which includes verifying both the mergeability of the branch and the approval status before proceeding with the merge.

When should I not use automated merging for my pull requests?

You should not use automated merging for pull requests that lack formal approval, have unresolved merge conflicts, or are not yet ready for integration into the main branch, as the validation checks will prevent the merge.