# Gh Pr Merge

> Merge GitHub pull requests using gh CLI with merge, squash, or rebase strategies and optional auto-merge.

- Skill: `dceoy/gh-pr-merge` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dceoy/gh-pr-merge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dceoy/gh-pr-merge/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dceoy (https://skillmd.com/u/dceoy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dceoy/gh-pr-merge

---


# GitHub PR Merge

## When to use

- The user asks to merge an approved PR.
- You need to enable auto-merge.

## Inputs to confirm

- PR number/URL/branch (or use current branch PR).
- Merge strategy: `--merge`, `--squash`, or `--rebase`.
- Whether to delete the branch, use auto-merge, or use admin override.

## Workflow

1. Verify auth and PR status:
   ```bash
   gh --version
   gh auth status
   gh pr view 123
   ```
2. Merge:
   ```bash
   gh pr merge 123 --squash
   gh pr merge 123 --merge --delete-branch
   ```
3. Enable auto-merge if required checks are pending:
   ```bash
   gh pr merge 123 --auto --squash
   ```

## Examples

```bash
# Squash merge and delete branch
~ gh pr merge 123 --squash --delete-branch
```

## Notes

- If a merge queue is required, `gh pr merge` will use it automatically.
- Use `--admin` only when you have permission to bypass requirements.

## References

- GitHub CLI manual: https://cli.github.com/manual/
- `gh pr merge --help`