> ## Documentation Index
> Fetch the complete documentation index at: https://theagenticguy.github.io/opencodehub/llms.txt
> Use this file to discover all available pages before exploring further.
> Scoped bundles: [user-guide](https://theagenticguy.github.io/opencodehub/_llms-txt/user-guide.txt) · [mcp](https://theagenticguy.github.io/opencodehub/_llms-txt/mcp.txt) · [contributing](https://theagenticguy.github.io/opencodehub/_llms-txt/contributing.txt)

# codehub-pr-description

Linear skill. No subagents. Sonnet. Writes a Markdown PR body you can
paste into `gh pr create --body-file` (or let the Claude Code session
drive the GitHub CLI directly).

## Frontmatter

```yaml
name: codehub-pr-description
argument-hint: "[--base <rev>] [--head <rev>] [--out <path>]"
color: teal
model: sonnet
```

## Preconditions

- `git diff --name-only <base>..<head>` must return ≥ 1 path. **Refuses on a clean tree** with `No diff detected — resolve base/head or stage changes.`

## Process

1. Resolve `--base` (default `main`) and `--head` (default `HEAD`).
2. `mcp__opencodehub__detect_changes({base, head})` → affected symbols + processes.
3. `mcp__opencodehub__verdict({base, head})` → 5-tier merge recommendation.
4. `mcp__opencodehub__owners({paths})` → required reviewers per path.
5. `mcp__opencodehub__list_findings_delta({base, head})` → new / resolved scanner findings.
6. For verdict tier ≥ 3: `mcp__opencodehub__impact({symbol, direction: "downstream", depth: 2})` — spell out who breaks.
7. For public API changes: `mcp__opencodehub__api_impact({route})` when the diff touches a handler.
8. Assemble the Markdown body and write to `<out>` (default `.codehub/pr/PR-<branch>.md`).

## Output shape

```markdown
# <branch-name or commit subject>

## Summary
2–3 sentences — what changes, why.

## Verdict
**Tier <N> — <label>** per `mcp__opencodehub__verdict`.
Reasons: ... (from verdict.reasons[])

## Affected surface
| Category | Count | Details |
|---|---|---|
| Files changed | N | ... |
| Symbols added | N | ... |

### Top touched files
| File | Change | Top owner |

## Blast radius           ← tier ≥ 3 only
## Findings delta
## Required reviewers
## Test plan
```

## Arguments

| Flag | Meaning |
|---|---|
| `--base <rev>` | Base revision. Default: `main`. |
| `--head <rev>` | Head revision. Default: `HEAD`. |
| `--out <path>` | Output path. Default: `.codehub/pr/PR-<branch>.md`. |

## Related

- [codehub-document](/opencodehub/skills/codehub-document/) — for architecture docs, not PR bodies
- [Skills index](/opencodehub/skills/)