1

    Pull Request Description Writer — Turn a Diff Into the PR Description a Reviewer Actually Wants

    by PubsProToolkit

    Turn a diff into a structured pull request description — what changed and why, guidance on where to review and what's risky, honest testing notes, and migration/rollback notes. Scaled to the size of the change, so review is faster and the merge is safer.

    Updated Jul 2026
    Security scanned
    including Claude Code

    $9

    · or 45 credits

    30-day refund guarantee

    Secure checkout via Stripe

    Included in download

    • Convert complex diffs into logical grouped summaries
    • Highlight risky code sections for reviewers
    • file_read, file_write automation included
    • Ready for including Claude Code
    • Instant install

    Media gallery

    See it in action

    You say

    Write a PR description for this diff. It refactors the auth-middleware.ts to use Redis for session storage and adds a rate limiter. The ticket is Jira-402. I ran unit tests but not e2e tests yet.

    Your agent does

    Summary

    Refactors auth-middleware.ts to use Redis for session storage, replacing the in-memory store to support horizontal scaling. Addresses [JIRA-402].

    Review Guidance

    Focus on middleware/rate-limiter.ts. I am unsure if the Redis connection timeout is too aggressive for high-latency spikes.

    Testing

    • Unit tests: Passed.
    • E2E tests: Not performed.
    • Manual: Verified session persistence across server restarts.

    About This Skill

    A pull request is a request for someone's time, and most PRs waste it: a one-line title over a 600-line diff, no why, no pointer to the risky part, no note on what was tested — so the reviewer reverse-engineers the intent from the code, slowly and often wrongly. AI-generated PRs are worse, because the agent rarely explains its reasoning at all. Pull Request Description Writer writes the description from the diff. Give it the changed files and, ideally, the ticket the work addresses, and it produces a reviewer-focused description: a summary that leads with why, the meaningful changes grouped by behavior rather than listed file-by-file, review guidance that points the reviewer to where to start and what's risky (the single biggest time-saver), an honest testing section that includes what was deliberately not covered, and risk, migration, and rollback notes where they apply. It scales the description to the change — a one-line fix gets a summary and a test note, a risky migration gets the full set — and it flags any why it had to infer for the author to confirm rather than inventing a motivation. The download includes three reference files: the PR-description template, a review-guidance checklist, and a worked sample. It writes from the diff and context you provide — it doesn't run the code or verify tests, so testing claims come from what you tell it. Works with Claude Code, Cursor, Codex CLI, Gemini CLI, and any SKILL.md agent.

    Use Cases

    • Convert complex diffs into logical grouped summaries
    • Highlight risky code sections for reviewers
    • Standardize PR documentation across a development team
    • Document testing notes, migrations, and rollback steps from the details you provide
    • Write clear descriptions for agent-generated PRs so human review stays efficient

    How to install

    Drop the file into your AI tool. Works with Claude, Cursor, ChatGPT, and 20+ more.

    Reviews

    No reviews yet - be the first to share your experience.

    Only users who have downloaded or purchased this skill can leave a review.

    Security Scanned

    Passed automated security review

    Permissions

    Read Files
    Write Files

    File Scopes

    references/**

    Read Files is used to read the diff and context files you point it at; Write Files is used to write the generated PR description to a file. The skill needs no Terminal/Shell, Browser, Network Access, or Environment Variables: it does not run code, execute or verify tests, or connect to GitHub, GitLab, or any repository or external host. Bundled reference files live under references/.

    Works with any agent that follows the open SKILL.md standard, including Claude Code, Cursor, Codex CLI, and Gemini CLI. No runtime, build step, or dependencies required — the skill reads the diff and context you provide. It does not run code, execute or verify tests, or connect to GitHub, GitLab, or any repository.

    Creator

    PubsProToolkit builds rigor-first skills for AI agents — they write your docs and content properly, then adversarially review them to catch what's wrong before it ships. The result: cleaner output and a hard quality gate in one toolkit. Built by a CMPP-certified, PhD medical writer who brings regulated-industry standards to developer docs, content, compliance, and research integrity.

    Frequently Asked Questions

    More Premium Skills

    $9