How do I install the Merge skill?

Run npx skillmds@latest add yokeloop/merge in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Merge safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Merge?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Merge free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

yokeloop (@yokeloop) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Merge by yokeloop — Agent Skill

Name: Merge
Author: yokeloop

Merge

The user-triggered finisher that executes the post-PR tail per `.yoke/flow.md`: merges the task's PR(s), runs cascade merges, runs deploy/release commands, moves the ticket to its target state, cleans up worktrees, and returns to the default branch. Activates when the user writes "merge", "merge it", "/merge", "finish the task", "ship it", "cascade and deploy", or after the user approves a PR on GitHub. Never runs on its own — the merge decision stays the user's.

yokeloop 0ea747a 2 files · 7.8 KB Updated Sep 17, 2026

File contents

Finish the task: merge, cascade, deploy, transition, clean up

The flow ends at PR (ADR-0006): do drives every run to a ready pull request and stops there. The merge decision is the user's, made on GitHub. /merge turns that one decision into one command — it executes the whole post-PR tail per the flow map instead of the user dictating the same paragraph every session.

Principle: merging is the user's call; /merge runs only on the explicit word.

Input

$ARGUMENTS — optional PR URL(s) or a <slug>. Empty means the current branch/worktree's task: resolve its open PR(s) via gh (e.g. gh pr view, gh pr list --head <branch>).

Procedure

Read the flow map once at the project root:

bash ${CLAUDE_PLUGIN_ROOT}/lib/flow-read.sh

Then read and follow reference/merge-procedure.md — the one reference this skill routes to for the full mechanics. It runs this step sequence, each step skipped silently when the flow map does not declare it:

Merge PR(s) — merge the task's pull request(s) on GitHub.
Cascade — advance the branch cascade (e.g. master → staging → develop) by each declared step command.
Deploy / release — run the DEPLOY_COMMANDS the flow map declares, nothing inferred.
Ticket transition — move the task's ticket to its target state.
Worktree cleanup — remove the task's worktree(s) and delete merged branches.
Return to the default branch — sync and land on the repo's default branch.

Rules

Never auto-runs. /merge fires only on an explicit user command — no automatic trigger after do, ever. The merge decision stays the user's.
Skip undeclared steps silently. A step whose section is absent from the flow map is skipped without nagging — omission means "apply the default", never "fail".
Multi-repo. Merge every one of the task's PRs; libraries were already direct-pushed by do, so there is nothing to merge for them.
Git authorization comes from the skill invocation itself — see "Git initiative and defaults" in ${CLAUDE_PLUGIN_ROOT}/skills/gca/reference/commit-convention.md. Do not restate it; do not ask "merge?" mid-run.
Artifacts only under .yoke/.
Any fork — an ambiguous PR set, a merge conflict, an unclear target — is one AskUserQuestion with a recommended option listed first.
Language: match the ticket/input language, or follow the project-level definition in CLAUDE.md / AGENTS.md.

Notify

On finish, send the terminal STAGE_COMPLETE notification with what was merged and deployed — the exact call lives in reference/merge-procedure.md §7.

---name: mergedescription: The user-triggered finisher that executes the post-PR tail per `.yoke/flow.md`: merges the task's PR(s), runs cascade merges, runs deploy/release commands, moves the ticket to its target state, cleans up worktrees, and returns to the default branch. Activates when the user writes "merge", "merge it", "/merge", "finish the task", "ship it", "cascade and deploy", or after the user approves a PR on GitHub. Never runs on its own — the merge decision stays the user's.---# Finish the task: merge, cascade, deploy, transition, clean upThe flow ends at PR (ADR-0006): `do` drives every run to a ready pull request andstops there. The merge decision is the user's, made on GitHub. `/merge` turns thatone decision into one command — it executes the whole post-PR tail per the flowmap instead of the user dictating the same paragraph every session.**Principle:** merging is the user's call; `/merge` runs only on the explicit word.---## Input`$ARGUMENTS` — optional PR URL(s) or a `<slug>`. Empty means the currentbranch/worktree's task: resolve its open PR(s) via `gh` (e.g. `gh pr view`,`gh pr list --head <branch>`).---## ProcedureRead the flow map once at the project root:```bashbash ${CLAUDE_PLUGIN_ROOT}/lib/flow-read.sh```Then read and follow `reference/merge-procedure.md` — the one reference this skillroutes to for the full mechanics. It runs this step sequence, each step **skippedsilently when the flow map does not declare it**:1. **Merge PR(s)** — merge the task's pull request(s) on GitHub.2. **Cascade** — advance the branch cascade (e.g. master → staging → develop) by each declared step command.3. **Deploy / release** — run the `DEPLOY_COMMANDS` the flow map declares, nothing inferred.4. **Ticket transition** — move the task's ticket to its target state.5. **Worktree cleanup** — remove the task's worktree(s) and delete merged branches.6. **Return to the default branch** — sync and land on the repo's default branch.---## Rules- **Never auto-runs.** `/merge` fires only on an explicit user command — no automatic trigger after `do`, ever. The merge decision stays the user's.- **Skip undeclared steps silently.** A step whose section is absent from the flow map is skipped without nagging — omission means "apply the default", never "fail".- **Multi-repo.** Merge every one of the task's PRs; libraries were already direct-pushed by `do`, so there is nothing to merge for them.- **Git authorization** comes from the skill invocation itself — see "Git initiative and defaults" in `${CLAUDE_PLUGIN_ROOT}/skills/gca/reference/commit-convention.md`. Do not restate it; do not ask "merge?" mid-run.- **Artifacts only under `.yoke/`.**- **Any fork** — an ambiguous PR set, a merge conflict, an unclear target — is one AskUserQuestion with a recommended option listed first.- **Language:** match the ticket/input language, or follow the project-level definition in CLAUDE.md / AGENTS.md.---## NotifyOn finish, send the terminal STAGE_COMPLETE notification with what was mergedand deployed — the exact call lives in `reference/merge-procedure.md` §7.

Frequently asked questions