# Pr Description

> Use when writing or updating a PR description on GitHub. Triggers on "write PR description", "update PR body", "describe this PR".

- Skill: `tomevault-io/pr-description` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/pr-description`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/pr-description/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/pr-description

---


# Generate PR Description

Create a comprehensive pull request description based on the changes in this branch relative to `main`, then update the PR on GitHub.

## Usage

```
/pr-description <PR_URL_or_NUMBER>
```

**Examples:**
```bash
/pr-description https://github.com/your-org/your-repo/pull/123
/pr-description 123
```

## What It Does

1. **Analyzes Changes**
   - Runs `git diff main HEAD` to understand modifications
   - Reviews commit messages with `git log main..HEAD --oneline`

2. **Generates Content**
   - **Title**: Concise descriptive title (max 72 chars)
   - **Summary**: Clear summary of what the PR accomplishes
   - **Changes Made**: Key changes, highlights breaking changes
   - **Testing**: How changes were tested, new test cases
   - **Related Issues**: Links to related issues or tickets

3. **Updates GitHub**
   - Uses `gh pr edit` to update the PR title and body
   - Falls back to manual copy/paste if `gh` CLI unavailable

## Notes

- Requires `gh` CLI to be installed and authenticated
- Automatically detects PR number from URL
- Highlights breaking changes prominently
- Formats output as proper markdown

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/v1-io) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->