# pr-desc

> Update PR description from current branch context

- Author: Salim Hamed
- Repository: salimhamed/claude-code-flow
- Version: 20260207134207
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-08
- Source: https://github.com/salimhamed/claude-code-flow
- Web: https://mule.run/skillshub/@@salimhamed/claude-code-flow~pr-desc:20260207134207

---

---
description: Update PR description from current branch context
disable-model-invocation: true
allowed-tools:
  - Bash(git *)
  - Bash(gh *)
  - Bash(python *)
---

# Update PR Description

!read references/usage.md

## Arguments

This skill accepts an optional argument with additional instructions for the
description.

**Example:** `/flow:pr-desc include a ## Usage section showing how to use each skill`

If provided, incorporate these instructions into the description format below.

## Gather Context

Run the gather script:

```bash
python scripts/gather_context.py
```

## Preconditions

Check these in the JSON output BEFORE proceeding:

1. **PR must exist**: If `pr_number` is null, STOP and say: "Error: No PR exists
   for this branch. Use /flow:pr to create one first."

## Execution

Update the PR body:

```bash
python scripts/update_description.py --body "<new body>"
```

## Body Format

Use this structure as a base:

```
## Summary

- <bullet 1: main change, start with verb>
- <bullet 2: supporting change or context>
- <optional bullet 3-4 if needed>
```

**If user provided additional instructions**, add the requested sections
after ## Summary.

Rules:

- 2-4 bullets only
- Each bullet starts with a verb (Add, Fix, Update, Remove, etc.)
- Focus on WHAT and WHY, not HOW
- No file paths unless the file itself is the feature
- No implementation details
- Derive content from commits and diff, not the old body
- If user requested additional sections, add them after Summary
- User instructions override the default format when they conflict
- Do not include any watermark, attribution, or "Generated by" text

## Output

After updating, output:

```
Updated PR #<number> description
<url>
```