Agent skill

PR Summarizer

by oxbshw in oxbshw/LLM-Agents-Ecosystem-Handbook

A skill your agent uses when opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base.

MITAuto-check: notesDevelopment

Install PR Summarizer

skills CLI
$ npx skills add oxbshw/LLM-Agents-Ecosystem-Handbook --skill pr-summarizer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install oxbshw/LLM-Agents-Ecosystem-Handbook pr-summarizer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/oxbshw/LLM-Agents-Ecosystem-Handbook.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/catalog/pr-summarizer .claude/skills/pr-summarizer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pr-summarizer
GitHub stars
552
Token cost
~441 tokens
SKILL.md length
206 words
Files
2 (incl. references)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base.

  • Works in 7 steps: git diff ...HEAD --stat and git log… → git diff ...HEAD for content → Group changes by area (one bullet per… → …
  • Opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base
  • SKILL.md covers When to use, When NOT to use, Inputs and Outputs, plus 4 more sections
  • Calls git

What it does

PR Summarizer is an agent skill from oxbshw/LLM-Agents-Ecosystem-Handbook. Use when opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base.

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/pr-template.md`).

It sits in Development, covering Pull requests. It works with Git. The repository describes itself as: One-stop handbook for building, deploying, and understanding LLM agents with 60+ skeletons, tutorials, ecosystem guides, and evaluation tools. The licence is MIT.

When your agent uses it

  • Opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base
  • Tasks that involve Pull requests

Example prompts

  • “/pr-summarizer”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. git diff ...HEAD --stat and git log ..HEAD --oneline to see scope
  2. git diff ...HEAD for content
  3. Group changes by area (one bullet per logical concern, not per file)
  4. Pull "why" from commit messages + linked tickets if mentioned
  5. Identify test artifacts touched; surface as How tested (or flag if none)
  6. Risks: any High-risk paths touched? auth, billing, migrations? mention.
  7. Linked: parse Fixes # / Refs # from commits

What it can do on your machine

Read from SKILL.md and the folder at commit 7f8ee3c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

PR Summarizer loads about 441 tokens when it runs, and up to ~532 if it reads all its reference files. Until then it costs about 35 tokens; SKILL.md has 206 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~441
With references · SKILL.md plus every file in references/, read only if the agent opens them
~532

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:48
    - Diff touches secrets / `.env*` → STOP and surface; PR shouldn't include them

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from oxbshw/LLM-Agents-Ecosystem-Handbook at commit 7f8ee3c, republished under its MIT licence (© oxbshw). 206 words, ~441 tokens.

Download SKILL.mdSave it as .claude/skills/pr-summarizer/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pr-summarizer
description
Use when opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base.
version
0.1.0
status
experimental
risk
low
tags
engineering, read-only, writes-files

PR Summarizer

When to use

  • Just before opening a PR
  • After force-pushing a substantive update to an existing PR (refresh description)

When NOT to use

  • Drafts the user is still iterating on (the summary will go stale immediately)
  • Massive diffs (> 1000 lines) — ask the user to scope first

Inputs

NameTypeRequiredNotes
basestringnodefault origin/main
branchstringnodefault current HEAD

Outputs

A markdown PR body with sections: Summary, Why, How tested, Risks, Linked.

Workflow

  1. git diff <base>...HEAD --stat and git log <base>..HEAD --oneline to see scope
  2. git diff <base>...HEAD for content
  3. Group changes by area (one bullet per logical concern, not per file)
  4. Pull "why" from commit messages + linked tickets if mentioned
  5. Identify test artifacts touched; surface as How tested (or flag if none)
  6. Risks: any High-risk paths touched? auth, billing, migrations? mention.
  7. Linked: parse Fixes # / Refs # from commits

References

Success criteria

  • Description ≤ 25 lines
  • Every "why" claim is supported by a commit message or visible in the diff
  • Risks section honest about unknowns ("untested in production data shape")

Failure modes

  • No commit messages worth quoting → "Why" sourced from diff only; flag this
  • Diff touches secrets / .env* → STOP and surface; PR shouldn't include them

© oxbshw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/catalog/pr-summarizer of oxbshw/LLM-Agents-Ecosystem-Handbook.

  • SKILL.md
  • references/pr-template.md

Open the folder on GitHubat commit 7f8ee3c

Compare with similar skills

PR Summarizer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

PR Summarizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PR Summarizer this skilloxbshw/LLM-Agents-Ecosystem-Handbook552—~441Automated safety check: NotesMIT
Orchestratetetherto/qvac683—~2kAutomated safety check: PassApache-2.0
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Open Code Review CLIalibaba/open-code-review45k—~3.1kAutomated safety check: PassApache-2.0
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Orchestrate

    tetherto/qvac

    Run the full implement → test → CI → review → PR pipeline for a task.

    683 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    45k GitHub stars~3.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Pull Request Title and Body Writer

    openinterpreter/openinterpreter

    Rewrites the title and body of one or more pull requests with gh, leading with why the change was made, then what changed, and describing only the net result.

    69k GitHub starsUsed in 2 repos~1.1k tokens
    DevelopmentAuto-check passed

More from oxbshw/LLM-Agents-Ecosystem-Handbook

  • API Design Reviewer

    oxbshw/LLM-Agents-Ecosystem-Handbook

    A skill your agent uses when reviewing a proposed REST or GraphQL API change before merge — checks contract clarity, backwards compatibility, errors, pagination, auth, and naming.

    552 GitHub stars~553 tokensUpdated 3 mo ago
    Auto-check passed
  • Dataset Profiler

    oxbshw/LLM-Agents-Ecosystem-Handbook

    A skill your agent uses when first encountering a new dataset — produces a structured profile (schema, missingness, distributions, outliers, gotchas) before any analysis.

    552 GitHub stars~492 tokensUpdated 3 mo ago
    Auto-check passed
  • Adr Writer

    oxbshw/LLM-Agents-Ecosystem-Handbook

    A skill your agent uses when capturing an architecture decision so it survives turnover — produces an ADR-NNNN.md from context, options considered, and the chosen path.

    552 GitHub stars~476 tokensUpdated 3 mo ago
    Auto-check passed
  • Sprint Planner

    oxbshw/LLM-Agents-Ecosystem-Handbook

    A skill your agent uses when planning the next sprint — turns ticket intake + team capacity into a planned sprint with explicit non-goals.

    552 GitHub stars~429 tokensUpdated 3 mo ago
    Auto-check passed
  • Incident Postmortem

    oxbshw/LLM-Agents-Ecosystem-Handbook

    Use after an incident is resolved — drafts a blameless postmortem from timeline notes, alerts, and chat threads.

    552 GitHub stars~461 tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about PR Summarizer

What does PR Summarizer do?

A skill your agent uses when opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base. PR Summarizer is an agent skill from oxbshw/LLM-Agents-Ecosystem-Handbook. Use when opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base.

When should I use PR Summarizer?

PR Summarizer fits situations like: opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base; tasks that involve Pull requests.

How do I install PR Summarizer in Claude Code?

Run `npx skills add oxbshw/LLM-Agents-Ecosystem-Handbook --skill pr-summarizer -a claude-code`. Or copy the skill folder (skills/catalog/pr-summarizer in oxbshw/LLM-Agents-Ecosystem-Handbook) into .claude/skills/pr-summarizer in your project. Claude Code loads it when a task matches its description.

How do I install PR Summarizer in Codex?

Run `npx skills add oxbshw/LLM-Agents-Ecosystem-Handbook --skill pr-summarizer -a codex`. Or copy the skill folder (skills/catalog/pr-summarizer in oxbshw/LLM-Agents-Ecosystem-Handbook) into .agents/skills/pr-summarizer in your project. Codex loads it when a task matches its description.

Can I use PR Summarizer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oxbshw/LLM-Agents-Ecosystem-Handbook --skill pr-summarizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pr-summarizer, .gemini/skills/pr-summarizer, .github/skills/pr-summarizer and .opencode/skills/pr-summarizer in your project.

What does PR Summarizer need to run?

Going by SKILL.md and its folder, PR Summarizer needs the command-line tools its instructions call (git).

Does PR Summarizer access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is PR Summarizer safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does PR Summarizer use?

PR Summarizer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PR Summarizer use?

About 441 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 91 tokens, read only when the agent opens those files.

What are the alternatives to PR Summarizer?

Skills that share tags, products or a category with PR Summarizer: Orchestrate (tetherto/qvac, 683 stars), Finishing a Development Branch (obra/superpowers, 297k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Open Code Review CLI (alibaba/open-code-review, 45k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PR Summarizer?

oxbshw (a GitHub user) maintains it in oxbshw/LLM-Agents-Ecosystem-Handbook, which has 552 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on June 30, 2026.

Source: oxbshw/LLM-Agents-Ecosystem-Handbook on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.