Skip to main content
skill CX Codex

resolve-pr-conflicts — Claude Code skill: what it does & setup

Guides coding assistants through resolving pull request merge conflicts inside an isolated Git worktree without touching main branches or breaking local edits.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jssblck/agents --skill resolve-pr-conflicts -a claude-code
Open on GitHub

What resolve-pr-conflicts does

The skill establishes a strict procedure for rebasing or merging PR branches. It starts by reading pull request metadata, head SHAs, and repository permissions using GitHub CLI. Operations run inside a temporary git worktree, keeping your current uncommitted working directory intact.

Branch updates follow the target repository's preferred strategy. Rewriting commit history requires clear confirmation, and any force push must use --force-with-lease targeting the recorded head SHA. Pushing directly to the base branch is explicitly prohibited.

After conflict hunks are resolved, the assistant runs repository linters, formatting, and test suites on the merged tree. Without a functioning gh CLI installation, the assistant cannot inspect PR state or verify remote permissions.

What it helps with

  • update conflicting pull request branches against an updated base
  • prevent corruption of uncommitted local edits via temporary worktrees
  • run project linters and test suites before pushing resolutions
  • guard against race conditions during force pushes using --force-with-lease

Example prompts for the agent

  • Resolve the merge conflicts in PR #42 against main
  • Sync PR branch 18 with its base and run the tests
  • Update this PR with the latest changes from upstream and fix any conflicts

How to install resolve-pr-conflicts

1Skills CLI (Vercel)

npx skills add jssblck/agents --skill resolve-pr-conflicts -a claude-code

2Manually: put the files in place

~/.claude/skills/resolve-pr-conflicts/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/resolve-pr-conflicts/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about resolve-pr-conflicts

How do I install resolve-pr-conflicts in Claude Code?

Run npx skills add jssblck/agents --skill resolve-pr-conflicts -a claude-code in your terminal.

What does resolve-pr-conflicts do?

It provides safety rules and steps for resolving Git merge conflicts on pull requests. The agent works in a temporary worktree, verifies build and test passes, and updates the PR branch.

Can this skill merge the pull request into main?

No, it only updates the PR branch against its base. Direct pushes to the base branch and unauthorized final merges are prohibited.

Similar skills

All skills for Git and GitHub →

From the same set10

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor