pr
Skill1 starsChanged 3 days agoMITView on GitHub
Opens, updates, dresses, and summarises pull requests. Use whenever a branch is pushed for review, a PR is created or edited, or someone asks to open, update, dress, review, or summarise a PR. Reads the repo's own conventions (base branch, PR template, title format, labels, checks) and follows them instead of inventing one. Make sure to use this skill even when the user says only "open a PR" or "update the PR"; never freehand a title or body when the repo documents a format.
- Commits and pushes
In this repository22 other files it gives its agents.
- analyze-logsSkill
- architectSkill
- build-audit-logsSkill
- cloudflareSkill
- code-reviewSkill
- design-engineeringSkill
- diagnosing-bugsSkill
- full-sendSkill
- full-stopSkill
- ghSkill
- grillingSkill
- impeccableSkill
- improve-animationsSkill
- interrogateSkill
- no-use-effectSkill
- retroSkill
- t3-toolsSkill
- triageSkill
- unslopSkill
- vitestSkill
- wait-whatSkill
- writing-for-agentsSkill
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 7 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
Update it rather than opening a second one.
- Distinctive: line 23
The issue behind the branch,: when one exists. Fetch it.
- Distinctive: line 29
Read them, do not assume them:
- Very specific: line 44
Default, when the repo documents nothing: <type>: <description>.
- Distinctive: line 76
Every linked issue gets exactly one keyword.
- Distinctive: line 84
Put it in the summary so it is unambiguous.
- Very specific: line 87
Write the prose through unslop.
- Very specific: line 98
Add the board when the repo uses them: gh project list --owner <owner> is the source of truth for the numbers.
- Distinctive: line 100
Never invent a label or a board number.
- Distinctive: line 120
Run the repo's documented CI command, not a generic one.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Pull request
The repo decides the conventions. This skill finds them and follows them. A repo may
override any of this with its own .agents/skills/pr/SKILL.md; that file wins.
1. Preflight read
Before writing anything:
- Repo rules.
AGENTS.md,CONTRIBUTING.md,.github/pull_request_template.md, and the repo's own.agents/skills/pr/SKILL.mdif it exists. Read them; a source you have not read does not count. - Base branch. The repo says it (
Dev,main,develop), otherwise the remote default:git symbolic-ref --short refs/remotes/origin/HEAD. Never guess. - Existing PR.
gh pr view --json title,body,labels,assignees,projects,isDraft. Update it rather than opening a second one. - The change.
git diff <base>...HEADandgit log <base>..HEAD --oneline. - The issue behind the branch, when one exists. Fetch it; never invent an issue.
- Reverse state. Archive ↔ restore, open ↔ close. When the change has one, both directions are implemented and verified, and the body says so.
2. Conventions
Read them, do not assume them:
| What | Where it lives |
| Title format | CONTRIBUTING.md, the PR template, git log --oneline -20 |
| Body sections | .github/pull_request_template.md |
| Labels | gh label list is the source of truth for the vocabulary |
| Boards / projects | gh project list --owner <owner> |
| Checks | the repo's CI workflow, AGENTS.md, or CONTRIBUTING.md |
Where the repo documents a format, follow it exactly, including its prefixes and type words. Where it documents nothing, use the defaults below.
3. Title
Default, when the repo documents nothing: <type>: <description>.
- Type:
feat,fix,chore,docs,refactor,test,perf. - Description: the change in one clause, imperative mood, no trailing period.
The title reaches the changelog, so name the product change, not the files. "Reports now filter by owner" lands; "refactored report filter" does not.
Done when: the title matches the format the repo documents.
4. Body
Fill the repo's template. Keep every heading it defines; drop only the sections that genuinely do not apply. Write for a reviewer who knows the product but not the codebase.
- Summary — the problem or need, then the solution. Two to four plain sentences.
- Changes — one bullet per meaningful change. Skip for a small PR.
- How can I test it? — the steps a reviewer follows by hand and what they should see. Manual verification only; check results already live in the CI UI.
- Screenshots or demo — required for any UI change. See step 6.
- Notes for reviewers — root cause for a fix, why this approach over the alternatives, reverse state. One short paragraph each.
- Anything to know before release? — migrations, flags, and config or data updates. Drop it when there are none.
Name things in the product's own words — Record inspector, Invoice template — not the
code's. "The record page now groups fields in a right-hand inspector" lands; "extracted a
RecordInspector component" does not. "Notes for reviewers" is the one section allowed
engineering vocabulary.
Traceability
Every linked issue gets exactly one keyword. The PR solves the issue or it does not; extra cleanup in the same PR does not change that.
Closes #N(Fixes/Resolves) — this PR solves the issue and closes it on merge. Use it even when the PR goes past the minimal fix.Refs #N(Related to) — the PR partially addresses, builds on, or merely references an issue that stays open.
Put it in the summary so it is unambiguous; several issues go on one comma-separated line. A PR does not need an issue invented for it.
Write the prose through unslop. No filler, no title-case headings the repo did not ask
for, no restating the diff.
Done when: the body keeps the template's headings and the issue keyword is unambiguous.
5. Labels, assignee, board
- One label for the kind of change, plus one area label for each area the change
touches.
gh label listgives the exact vocabulary; a shared package change takes its shared label and the product labels it affects. - Set the assignee (
--assignee @me) when the repo has one person per area. - Add the board when the repo uses them:
gh project list --owner <owner>is the source of truth for the numbers. A cross-cutting change lands on every board it affects. - Never invent a label or a board number. If the repo has no label scheme, ship without labels rather than guessing.
Done when: the labels and boards match what the repo actually defines.
6. Screenshots
- Quick before/after:
--attachthe files, alt text after#, and put a matchingin the body soghrewrites it to the upload URL. - Formats, limits, and edge cases are in the
ghskill under "Attaching images and videos". - The screenshot section is mandatory for any UI change, and every changed surface gets a capture.
Done when: every changed UI surface has a before/after capture.
7. Readiness gate
Push the tested commit before checking. Checks attach to the remote SHA.
- Run the repo's documented CI command, not a generic one.
- Mark ready only on green:
gh pr ready. A pending or failing check stays a draft. - Trust the forge's verdict, not a green checklist. Ready means GitHub agrees the required check succeeded on the pushed SHA.
- The body points at behaviour; it does not restate check results.
Done when: the draft is marked ready only after the required check is green on the head SHA.
8. Updating an existing PR
gh pr editfor title, body, labels, boards, and the issue link.- Preserve existing screenshots; only add new ones.
- Re-check the invariants in steps 3–7 after every edit, including the issue keyword: a
PR that grew extra cleanup still
Closesits issue. - In T3 Code, call
link_pull_requestaftergh pr create, andwatch_pull_requestwhen you need to wait on checks. Thet3-toolsskill has the exact tool names.
Done when: the edit still satisfies steps 3–7 and nothing required was dropped.
Guards
- The draft is the default state; readiness waits on a green check.
- Merge ownership belongs to the workflow that owns it. Mark ready, then stop, unless a
skill with explicit merge authority (such as
full-send) is running. - The scope of the PR matches the app named in the title and the area labels applied.
- The body's issue keyword and the template headings are part of the definition of done.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

