pr

Invoking this skill IS the request. Your task is fully specified here. Never ask what to do.

Run every command bare, exactly as written below: git and gh find the repository from any subdirectory, and a cd does not carry over to the next Bash call in this fork. A cd ... && or $() prefix stops a command matching allowed-tools, and the merge then hits the permission gate.

The user invoked this skill with: "$ARGUMENTS"

Mode comes from the arguments first: create means create mode, update means update mode, merge means merge mode. With none of those three words, including an empty argument, run gh pr view --json state --jq .state 2>/dev/null and let its result decide: a non-zero exit (no PR for this branch) means create mode, OPEN means update mode, any other state means report that state and stop. Merge mode only ever comes from the argument.

PR material

Create mode and update mode run these steps where they say "gather PR material":

1. git log --format='%n%s' --name-only main..HEAD (fall back to master..HEAD). Each commit is a block: its subject, then the files it touched. A flat log next to a branch-wide diff stat lets the writer guess which commit touched which file.
2. The PR describes the net change of the branch. A commit whose subject starts with Revert " and the commit it names cancel each other when both sit in the log, as does a later commit that restores what an earlier one removed, and a subject starting with build: bump describes no change. Remove those blocks from the log before passing it on.
3. git log --format=%b main..HEAD (same fallback). Collect every issue number written as #N or as a GitHub issue URL. Each one becomes a Fix #N line at the end of the body, one per line, no duplicates.
4. Invoke the write-like-me skill. Pass as argument: "Write a GitHub PR title and body from the material below. Shape the draft as the title on the first line, a blank line, then the body, and nothing else: the caller splits on the first line, so a label or heading would land in the title. The draft goes straight into the caller's next gh command in the same response, never into a reply: a reply with no tool call ends the caller before the PR exists.

Title: one plain-English line under 72 chars that names the change itself, with no fix: or feat: type prefix. GitHub shows titles as plain text, so write file names bare, without backticks. Body: GitHub renders it as markdown, so wrap every file path, command, flag, and identifier in backticks, at every occurrence. Leave out changes a reviewer would not miss, such as ignore files, asset moves, and personal config tweaks, unless the branch holds nothing else. Body shape depends on how many separate changes are left.

One change: 1-3 sentences of prose, what changed and why, no list.

Adds a pr skill that pushes the current branch, drafts a PR title and body with write-like-me, and opens the PR with gh. Wires it into the plugin manifest and marketplace so it ships with hal-skills. </example>

Two or more changes: one - item per change, each item 1-3 short sentences stating the change and one before/after example when the change has a visible input and output. Give every item its example, not only the first.

• Move name-suffix from AI spacing into the core rules.
• URLs are left alone. Anything starting with http:// or https:// is hidden from the rules, so %E4%B8%AD and /wiki/CJK#CJK survive.
• / next to CJK never gets spaces anymore. CJK/CJK stays CJK/CJK, same as _. File paths still work: CJK/homeCJK becomes CJK /home CJK.</example>

<material>" followed by the log from step 2, then a closing "</material>" line.

5. From write-like-me's output, take the first line as title, the rest as body. Append a blank line and the Fix #N lines from step 3 to the body.

Create mode

1. git rev-parse --abbrev-ref HEAD — abort if main or master.
2. gh pr view --json url 2>/dev/null — if a PR already exists, report its URL and stop.
3. git push -u origin HEAD.
4. Gather PR material.
5. gh pr create --title "<title>" --body "<body>".
6. Report the PR URL.

Update mode

1. gh pr view --json url,state 2>/dev/null — abort if no PR or not open.
2. git push, alone in its Bash call, every time: it prints Everything up-to-date when nothing is ahead. Abort if it fails.
3. Gather PR material.
4. gh pr edit --body "<body>" — the title stays as it is.
5. Report the PR URL.

Merge mode

1. gh pr view --json url,number,state — abort if no PR or not open.
2. git push, alone in its Bash call, every time: it prints Everything up-to-date when nothing is ahead. Abort if it fails.
3. git rev-parse HEAD, then gh pr view --json headRefOid --jq .headRefOid. If they differ, GitHub has not seen the push yet and gh pr checks would report the old head's runs: wait 15 seconds and compare once more, then abort if they still differ.
4. gh pr checks --watch — blocks until all checks complete. Use a 10-minute Bash timeout. If the push sent commits and it reports no checks yet, the push just queued them: wait 15 seconds and run it again once. If the call times out instead, the checks are still running: run it again with the same timeout, and after a third timeout report the checks still pending and stop.
5. If exit code 0 (all checks passed):
   • gh pr merge --merge --delete-branch. It also switches to the base branch, pulls it, and deletes the local branch.
   • Report: merged, remote and local branches cleaned up.
6. If non-zero (check failed):
   • Run gh pr checks once more to list failed checks and their URLs.
   • Report which checks failed. Take no other action.