Skip to content
Skills Library
Programming · Writing

pull-request-summary

/pull-request-summary

Drafts, revises, or checks a pull request description against the actual diff and the repository's template. Use whenever someone asks for a PR description or body, wants one updated after the scope changed, or wants it checked before publishing, including inside a delivery Skill.

Repository
brundlefly ↗
Licence
MIT
Last repository change
14.10.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Drafts, revises, or checks a pull request description against the actual diff and the repository's template. Use whenever someone asks for a PR description or body, wants one updated after the scope changed, or wants it checked before publishing, including inside a delivery Skill.

Original author description

Drafts, revises, or checks a pull request description against the actual diff and the repository's template. Use whenever someone asks for a PR description or body, wants one updated after the scope changed, or wants it checked before publishing, including inside a delivery Skill.

How it works

  1. 1. Establish the description inputs
  2. 2. Draft or revise the body
  3. 3. Check the description
  4. Caller contract
Original SKILL.md headings · 85 lines, 793 words
SKILL.md preview
---
name: pull-request-summary
description: "Drafts, revises, or checks a pull request description against the actual diff and the repository's template. Use whenever someone asks for a PR description or body, wants one updated after the scope changed, or wants it checked before publishing, including inside a delivery Skill."
license: MIT
---

# Pull request summary

Return a reviewable pull request description grounded in the actual change.
Consider the human reviewer, their existing context, and the decision the description must help them make.
Respect their attention. Optimize for clarity, accuracy, and brevity while keeping necessary consequences and operator actions.
Design for reading and attention needs, including ADHD and dyslexia.
Use examples or storytelling only when they clarify supported motivation or behavior. Never invent a personal experience.
This Skill owns description text only. The caller owns delivery and repository policy.
Do not create branches, stage files, commit, push, publish, manage CI, or post replies.
Do not change the PR title, labels, draft state, or reviewer decisions.

## 1. Establish the description inputs

Read applicable user instructions, repository rules, and the caller's description requirements.
Read [repository conventions](references/conventions.md) to resolve the effective template and contributor guidance.
Use supplied context or permitted read-only tools. No GitHub integration is required when the inputs are supplied.

Confirm the intended base and inspect the complete net diff, relevant commits, and supplied issue context.
For an existing PR, obtain its current body and identify the requested edit.
Ground motivation in the user's request, issue, or recorded intent.
Ask only when missing intent materially changes the description.
If a required source is unavailable, return the specific gap instead of inventing its contents.

## 2. Draft or revise the body

Lead with the concrete problem or goal, then explain the resulting behavior.
Let the diff carry routine implementation details.
Scale detail to risk. Small changes normally need one to three sentences.
Read [description examples](references/examples.md) for a revised generated body and a small change.
Include migration steps, measured comparisons, or examples only when they help the reviewer decide.

Follow the selected template and the caller's requirements.
Preserve mandatory headings, comments, disclosures, and checklists.
Remove optional empty sections only when the repository allows it.
Tick only supported facts. Leave human attestations for the human.
Report verification only where the applicable rules require or allow it.
Never turn missing checks into passing checks.

Preserve author-written notes, attachments, uncertainty, and decisions outside the requested edit.
Rewrite obsolete generated text around the final diff.
Use first-person experiences only when their author supplied them.
Never invent authorship, human review, measurements, consensus, deadlines, or promises.
Honor required AI disclosure. Preserve it during edits.
If disclosure rules require unknown facts, return that gap to the caller.

Use concrete words and short sentences. Cut prose that only shows effort.
Use sentence case for authored prose. Start sentences with a capital letter unless exact reference casing requires otherwise.
If a lowercase identifier starts a sentence, rephrase: "The `im-part-human` skill...". Never change the identifier's casing.
Format exact skill names, identifiers, commands, and file paths as inline code.
Use descriptive Markdown links when readers should open a referenced file, PR, issue, document, or source.
Keep ordinary product names in plain text. Preserve required wording, quoted text, and existing author material outside the edit.
Use lists when they help review. Preserve required template checklists.
Do not use em dashes or hyphens as sentence punctuation.
Use exact names and stated pronouns. Otherwise use a username or singular they.

## 3. Check the description

Apply [clarity](references/blocks/clarity.md), including ADHD and dyslexia guidance, to the reviewer's reading path.
Keep conditions beside the changes or operator actions they affect. Preserve required templates and complete checklists.
Do not fragment a short description with decorative headings or add background the reviewer does not need.
Before removing substantial author material, explain the proposed loss and ask unless removal is already authorized.

Apply [claim fidelity](references/blocks/claim-fidelity.md) against the diff, supplied intent, and required template wording.
For a revised body, also compare the preserved author material with the original body.
For a new body, use the supplied evidence as the source. Do not assume an earlier description exists.

Compare every factual claim with the diff and supplied evidence.
Check that motivation, scope, consequences, and migration match the final change.
Check the template, caller policy, disclosure, preserved material, and unsupported claims.
Check sentence starts for unnecessary lowercase. Preserve exact casing inside code, links, and quotations.
Check that technical references use inline code or useful links. Check link destinations against supplied or inspected evidence.
Revise the body until it passes these checks.

Return the final description text separately from any unresolved gaps.
If required inputs are missing, tell the caller which description checks could not complete.
A passing description check proves neither implementation correctness nor publication readiness.

## Caller contract

A delivery Skill supplies the diff, intent, effective template, existing body, and local description policy.
It may add disclosure formulas, section rules, diagrams, or repository-specific requirements.
This Skill applies those requirements and returns description text without taking over delivery.
The caller confirms the remote body before publication and reconciles concurrent edits.
Files in this package (6)
  • LICENSE.txt 1 KB
  • SKILL.md 6 KB
  • references/conventions.md 3 KB
  • references/examples.md 2 KB
  • references/blocks/claim-fidelity.md 4 KB
  • references/blocks/clarity.md 5 KB

Versions

The database has no other skills named pull-request-summary.

Database snapshot: 13.11.2026 · package version 62401f8d7d2f (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90create-pull-request
    Create or update the pull request for the current branch, with a description filled from this repository's PR template using the diff and CI evidence. Use when opening a PR, or writing or refreshing a PR description, checklist, or review summary.
  • 100descriptions
    Draft or revise a pull-request description. Use when a user asks for a "PR description", "pull request summary", or "change description".
  • 100pr-description
    Drafts clear pull request descriptions from a diff and repository context. Use when the user asks to write or improve a pull request description.
  • 90oak-commit
    Use when the user asks to commit or open a pull request, or when /autonomous reaches delivery - produces atomic commits that stage explicit paths only, with messages and a pull-request body written from the actual diff.
  • 100file-pr
    Write a pull request title and body grounded in the actual diff, as a local draft by default, and create or update the PR only when that is asked for or already authorized. Use when the user asks to write or fix a PR description, or to file, open, create or update a pull request.
  • 100pr-describe
    Write a pull request title and description from the actual diff and commits, including a risk line and how to test. Use when the user asks to write, draft, fill in or improve a PR description, open a PR, or summarise a branch for reviewers.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.