Skip to content
OpenCodeHub

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

Section titled “Frontmatter”
name: codehub-pr-description
argument-hint: "[--base <rev>] [--head <rev>] [--out <path>]"
color: teal
model: sonnet

Preconditions

Section titled “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

Section titled “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

Section titled “Output shape”
# <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

Section titled “Arguments”
FlagMeaning
--base <rev>Base revision. Default: main.
--head <rev>Head revision. Default: HEAD.
--out <path>Output path. Default: .codehub/pr/PR-<branch>.md.
Section titled “Related”