SKILL.md
Update Pull Request
The PR body documents what will happen when merged, not the journey. Don't echo review feedback. Only mention changes if the ultimate result is user-facing.
Arguments
$0 (optional): the PR/MR to update, given as a URL, number, or branch name. The Workflow passes it to gh pr view/glab mr view. Default: with no argument, the tools resolve the PR/MR from the current branch.
Context
- Remote URL: !
git remote get-url origin - PR Template: !
bun ${CLAUDEPLUGINROOT}/scripts/pr-template.ts
!bun ${CLAUDEPLUGINROOT}/scripts/git-context.ts
!bun ${CLAUDEPLUGINROOT}/scripts/contributing.ts
Workflow
- Fetch PR context: Use
$0(if provided) as a PR identifier (number or branch name). Fetch the current PR:
- GitHub: gh pr view $0 --json title,body,updatedAt,commits - GitLab: glab mr view $0
- Fetch PR diff:
- GitHub: gh pr diff $0 - GitLab: glab mr diff $0
- Filter commits after
updatedAtto identify new work since the body was last written.
Writing
- Rewrite the PR body per [
sections.md](../create/references/sections.md), the same rules the create skill follows. Load thewritingskill for the full set of tropes to avoid. If a PR template is provided in context, preserve its structure. - Write the updated body to a temp file (e.g.,
tmp/pr-body-<branch>.md) and apply:
- GitHub: gh pr edit --body-file tmp/pr-body-<branch>.md - GitLab: glab mr update --description-file tmp/pr-body-<branch>.md - A screenshot or recording the new body references by local path uploads with it: --attach ./shot.png per file on gh pr edit (load github:attach), or project uploads per gitlab:api pasted in before the update. Assets already in the body keep their uploaded URLs.
GitLab Notes
For advanced GitLab features (username lookup), load gitlab:merge-request.