github-pull-request

GitHub Pull Request

Create or update the pull request for the current branch against main with a What, Why, How, and Test plan body; feature-branch owns branch creation and conventional-commit the commits on it.

Workflow

1. Stop on main: a PR must come from a feature branch.

2. Gather context so the PR reflects the actual work, not only the commit subjects:

   git fetch origin main                                   # refresh origin/main for the ranges below
   git branch --show-current                               # current branch
   git status --short                                      # working tree state
   gh pr view --json number,state,url                      # existing PR for this branch (non-zero exit when none)
   git log --reverse --oneline origin/main..HEAD           # commits since main
   git diff --stat --find-renames origin/main...HEAD       # diff stats
   git diff --name-only --find-renames origin/main...HEAD  # changed files
   

3. Write the title in imperative mood, under 72 characters.

4. Write the body into a temporary file (never inline shell quoting) with these sections:

   ## What
   
   ## Why
   
   ## How
   
   ## Test plan
   

5. Push the branch with an upstream when it has none: git push -u origin "$(git branch --show-current)".

6. Create or update depending on step 2:

   gh pr edit --base main --title "<title>" --body-file <tmpfile>     # a PR exists
   gh pr create --base main --title "<title>" --body-file <tmpfile>   # no PR yet
   

7. Report the PR URL, the final title, and the final body; if origin/main or GitHub auth is unavailable, explain the blocker and stop.

Official Skills

Upstream: cli/cli. List the current release, then install what the task needs at project scope after reviewing the snapshot (see agent-skills):

gh skill preview cli/cli gh
gh skill install cli/cli gh