About merge
A Remotion monorepo skill for handling existing pull requests, from eligibility checks and CI failures through merge. It guides contributors to restart the review loop after each change in PR state.
Key features
- 01Check PR eligibility and status
- 02Resolve merge conflicts
- 03Monitor CI checks
- 04Diagnose failed jobs
- 05Merge eligible pull requests
Use cases
- 01Determine why a PR cannot merge
- 02Resolve conflicts and rerun the review loop
- 03Investigate CI failures before merging
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ remotion-dev/ remotion --skill mergeAfter installing, type/mergein Claude Code to confirm it loaded.
Details
From the project README/merge
Use this skill for an existing pull request in the Remotion monorepo.
Loop
Start from the top after every pushed fix, conflict resolution, CI rerun, or other state change:
- Identify the PR:
gh pr view --json number,url,state,isDraft,baseRefName,headRefName,mergeable,mergeStateStatus,reviewDecision,statusCheckRollup
-
If the PR is draft, closed, blocked by requested changes, missing required approval, or otherwise not eligible to merge for a non-CI reason, stop and report the blocker.
-
If GitHub reports merge conflicts, resolve them using the
pr-readyworkflow. Commit and push the resolution when needed, then start this loop from the top. -
Wait for checks:
gh pr checks --watch --interval 30
- If all required checks pass and the PR is mergeable, merge it:
gh pr merge --merge --delete-branch
If the repository or PR clearly requires another merge method, use that method instead.
CI Failures
When checks fail, inspect the failed jobs and logs before deciding what to do:
gh pr checks --watch=false
gh run view <run-id> --json databaseId,status,conclusion,url,jobs
gh run view <run-id> --log-failed
If it is a genuine CI failure:
- Fix the underlying issue locally, using the
pr-readyworkflow when helpful. - Run the targeted local checks, plus broader checks when the change has broad impact.
- Commit and push the fix.
- Start the loop from the top.
If it is a CI flake:
- Use the
flakeskill in this monorepo. - Rerun the failed flaky job or failed jobs as directed by that skill.
- Start the loop from the top.