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.
- Author
- harlan-zw ↗
- Repository
- brundlefly ↗
- Licence
- MIT
- Last repository change
- 14.10.2026
Assessment and security
- Files in this package
- 6
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.
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. Establish the description inputs
- 2. Draft or revise the body
- 3. Check the description
- Caller contract
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.