Pull Request Description Writer skill for Claude and Codex

Pull Request Description Writer as an AI skill. It asks for What changed, Why, Before and after evidence and 3 more, then does the rest. Free to install in…

Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.

Download the skill (.zip) · View SKILL.md

When it is used

Use when a pull request is ready to open and needs a clear body with evidence, test steps and a risk call. Do not use for asking a reviewer to look at specific code or writing release notes. Related topics: coding, communication.

What it will ask you for

• What changed (longer free text)
• Why (longer free text)
• Before and after evidence (longer free text)
• How to test (longer free text)
• Linked issue (free text, e.g. "Issue number or link")
• Breaking or risky parts (longer free text)

How it works

1. Write a title that states the effect and a two or three sentence summary of problem and fix.
2. Present before and after evidence exactly as supplied, without describing results that were not given.
3. List the notable changes by area and leave out trivial edits.
4. Write numbered test steps with an expected result for each.
5. Close with a low, medium or high merge-danger call, the reasons and a rollback plan.

What you get

A pull request body with title, summary, before and after, change bullets, numbered test steps, merge-danger call with rollback plan and the issue link.

What it watches out for

• Describing the diff line by line instead of the effect, which repeats what the reviewer can already see.
• Test steps that skip the setup, so the reviewer cannot reproduce them.
• Rating the merge low-risk while a migration is part of it.

How to install

Claude.ai and the Claude desktop app

1. Download the skill .zip.
2. Open Settings, then Capabilities, and find Skills.
3. Choose Upload skill and select the .zip.
4. Ask Claude for help with the task. It loads the skill when your request matches.

Claude Code

1. Download the skill .zip.
2. Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
3. Start a new session. Claude Code loads the skill when your request matches.

Codex

1. Download the skill .zip.
2. Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
3. Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.

Cursor

1. Download the Cursor rule (.mdc).
2. Save it in .cursor/rules/ inside your project.
3. Cursor's agent applies the rule when your request matches its description.

AGENTS.md (Codex, Cursor, and other coding agents)

1. Copy the AGENTS.md section.
2. Paste it into AGENTS.md at the root of your repository, creating the file if needed.
3. Coding agents that read AGENTS.md follow it when your request fits.