Home / Developers and data / Write a pull request description and review notes

Write a pull request description and review notes

Who it is for
Developers who dislike writing pull requests.
What you give it
Your branch, or a pasted diff.
What you get back
A title, summary, risk notes, a test plan and the questions a reviewer will ask.

It is a text file you add to an AI assistant, or paste into a chat.

Free. MIT licence: use it, change it, share it.

Before and after

Before: A commit-list dump: "fix res.send / bump qs / bump proxy-addr / bump morgan"

After (real output, from a real test run): Test run on four real commits from a public web framework. Output, unedited: "Title: Preserve ETag with Transfer-Encoding in res.send; bump deps". It grouped the fix and the three dependency bumps separately, noted which bumps were runtime vs dev, said the diff showed no lockfile change, wrote "Why: not stated in the diff", and caught that the branch it was asked to diff against was behind another branch.

What it does

Run it in your repository, or paste a diff. It reads the commits and the diff and gives you a ready-to-paste PR: title, summary, changes grouped by purpose, risk and review focus, how it was tested (only what is stated), up to five likely reviewer questions and a list of facts it could not get from the diff. It will not invent a reason, a ticket or a test result.

The evidence

1 real-data run on four public commits (Claude).

Limits

  • It only knows the diff and commit messages. The reason for the change comes from you.
  • It does not run tests. "How it was tested" says Not stated unless you tell it.
  • It does not open the PR. You paste the text.
  • Very large diffs: it reads the stat first and then the key files, and says what it skipped.

Questions

Questions or a problem?

Use the contact page.

Contact page

Which assistants does it work with?

Works in ChatGPT or any chatbot: you paste in your details and it writes the result. Inside a git repository it runs git itself. Otherwise paste a diff.

For technical users

Using it with an AI assistant

  1. Run npx skills add proskillpacks/skills in your project and pick this skill. Or copy the pr-description-and-review-prep folder from GitHub (https://github.com/proskillpacks/skills/tree/main/skills/developers/pr-description-and-review-prep).
  2. Put the pr-description-and-review-prep folder where your assistant looks for skills. The generic path is .agents/skills/ (or npx skills add from a folder). Tool-specific paths:
    • Claude Code: ~/.claude/skills/ (or .claude/skills/ inside one project)
    • OpenAI Codex, Gemini CLI, Cursor and others: .agents/skills/ or the skills folder their docs name
    • claude.ai: zip the skill folder yourself, then Customize, Skills, the plus button, Create skill, Upload a skill (code execution must be on in Settings, Capabilities)
    • ChatGPT or any chatbot: open the skill's prompt.md, paste it into the chat, then paste your own text or link
    • Steps for each tool, with links to its official docs: how to install skills
  3. Ask for the job in plain words, for example: "I am about to open a PR from this branch into main. Write the PR description.". The skill loads by itself.
Get the files from GitHub (for developers)

Jobs that go with this