Creates pull requests with properly formatted titles and descriptions following conventional commit style. Checks for uncommitted changes first and routes you to commit them before opening the PR. The description template skips the usual checkbox theater and focuses on what matters: what changed, why you made the change, and context reviewers actually need. Handles both modern and legacy GitHub CLI versions automatically, working around that old Projects classic deprecation bug if you're stuck on an older gh version. Integrates with the conventional-commit skill for the full workflow from changes to merged PR.

skills.sh installs
311
GitHub stars
19
last updated
Aug 21, 2026

Install

$ npx -y skills add marcelorodrigo/agent-skills --skill create-pr --agent claude-code

Installs into .claude/skills of the current project.

Files

Create Pull Request

Create pull requests following the best engineering practices.

Requires: GitHub CLI (gh) authenticated and available.

Prerequisites

Before creating a PR, ensure all changes are committed. If there are uncommitted changes, run the commit skill skill({ name: "conventional-commit" }) first to commit them properly.

# Check for uncommitted changes
git status --porcelain

If the output shows any uncommitted changes (modified, added, or untracked files that should be included), invoke the commit skill skill({ name: "conventional-commit" }) before proceeding.

Process

Step 1: Verify Branch State

# Detect the default branch
BASE=$(gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name')

# Check current branch and status
git status
git log $BASE..HEAD --oneline

Ensure:

  • All changes are committed
  • Branch is up to date with remote
  • Changes are rebased on the base branch if needed

Step 2: Analyze Changes

Review what will be included in the PR:

# See all commits that will be in the PR
git log $BASE..HEAD

# See the full diff
git diff $BASE...HEAD

Sponsors

Details

Repository
github.com/marcelorodrigo/agent-skills
Categories
Git & Pull Requests, Documentation, Code Review & Quality, AI & Agent Building
First seen
Jun 3, 2026

More from marcelorodrigo/agent-skills

All 4
1kkkkhazix avatargithub-to-skillskkkkhazix/khazix-skillsAutomated factory for converting GitHub repositories into specialized AI skills. Use this skill when the user provides a GitHub URL and wants to "package", "wra260skills.sh installs
2decebals avatarchangelog-generatordecebals/claude-code-javaGenerate changelogs from git commits. Use when user says "generate changelog", "update changelog", "what changed since last release", or before preparing a new 251skills.sh installs
3everyinc avatarchangelogeveryinc/compound-engineering-pluginCreate engaging changelogs for recent merges to main branch245skills.sh installs
4openai avatarpr-draft-summaryopenai/openai-agents-pythonCreate the required PR-ready summary block, branch suggestion, title, and draft description for openai-agents-python. Use before the final response whenever the236skills.sh installs
5yonatangross avatarissue-progress-trackingyonatangross/orchestkitGitHub issue workflow ceremony using gh CLI — labels issues as in-progress, creates feature branches (issue/N-description), commits with issue references, posts221skills.sh installs
6yonatangross avatarfix-issueyonatangross/orchestkitFixes GitHub issues using parallel analysis agents for root cause investigation, code exploration, and regression detection. Reads issue context from gh CLI, se217skills.sh installs