ShipfoxHQ/shipfox / .agents/skills/pr
pr
VerifiedALWAYS use this skill when creating pull requests. Applies Shipfox agent sequencing for GitHub CLI review preparation and pull-request creation. Trigger on create PR, open PR, submit PR, make PR, push and create PR, or prepare changes for review.
Create Pull Request
Create a pull request after applying the shared contributor rules and the agent workflow below.
Before opening a pull request, read the contributor review standard. It owns shared pull-request scope, title, description, and Linear-reference rules for humans and agents.
When the change may affect a published package, read the Changesets and publishing workflow. It owns when a Changeset is required and how releases are published.
Process
- Check
git status --porcelain. If intended changes are uncommitted, use the repository commit workflow. Ask before committing only when the intended scope is unclear. - Inspect
git status,git log origin/main..HEAD --oneline, andgit diff origin/main...HEAD. Confirm the branch is notmainand contains only the intended review scope. - Apply the shared Changeset rule. If one is required and absent, invoke the
generate-changesetskill or usepnpm exec changesetinteractively, then commit it before opening the pull request. - Use the contributor standard to prepare the title, description, and Linear
reference. Inspect the source issue and compare its requested scope with the
branch diff before choosing the keyword:
- Use
Closes ENG-123when the task implements that issue and no requested work remains. This is the default when the branch covers the full scope. - Use
Refs ENG-123,Part of ENG-123, orRelated to ENG-123only when the issue is an umbrella item, the pull request is an explicit partial step, or a named requirement remains for another pull request. State the remaining work in the description. - Optional follow-up improvements do not make the work partial. Neither do a
draft pull request, a narrow implementation, or a
Refscommit footer. Ask only when the issue and diff contain conflicting evidence that cannot be resolved by inspection.
- Use
- Push the branch when needed with
git push -u origin HEAD, then create the pull request:
gh pr create --base main --title "<title>" --body "$(cat <<'EOF'
<description body here>
EOF
)"
Pass --draft when the user request, task context, or arguments require it.
Before submission, inspect the final body. A pull request that completes a
Linear issue must contain a closing line such as Closes ENG-123. This lets the
Linear integration apply its merge automation.
Edit an existing pull request
Use gh api to update an existing pull request:
gh api -X PATCH repos/{owner}/{repo}/pulls/PR_NUMBER \
-f title='New title' \
-f body='New description'
Report the pull-request URL, branch, included commits, validation status, and any follow-up work.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |