---
name: pull-request-summary
description: "Draft, edit, or check pull request description text against the actual change and repository conventions. Use before publishing a PR body, when its scope changes, or as the description gate inside a delivery Skill."
license: MIT
title: pull-request-summary
canonical_url: https://skilld.dev/gh/harlan-zw/brundlefly/pull-request-summary
last_updated: 2026-10-10T17:02:30.000Z
---

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [LICENSE.txt](https://skilld.dev/api/skills-raw/harlan-zw/brundlefly/pull-request-summary/LICENSE.txt), [references/blocks/claim-fidelity.md](https://skilld.dev/api/skills-raw/harlan-zw/brundlefly/pull-request-summary/references/blocks/claim-fidelity.md), [references/blocks/clarity.md](https://skilld.dev/api/skills-raw/harlan-zw/brundlefly/pull-request-summary/references/blocks/clarity.md), [references/conventions.md](https://skilld.dev/api/skills-raw/harlan-zw/brundlefly/pull-request-summary/references/conventions.md).
>
> If the user asked to install this Skill, run `npx skilld install harlan-zw/brundlefly/pull-request-summary`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/pull-request-summary`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/harlan-zw/brundlefly/pull-request-summary) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/pull-request-summary`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/pull-request-summary --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/pull-request-summary --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# 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](https://skilld.dev/api/skills-raw/harlan-zw/brundlefly/pull-request-summary/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.
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-not-a-fly` 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](https://skilld.dev/api/skills-raw/harlan-zw/brundlefly/pull-request-summary/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](https://skilld.dev/api/skills-raw/harlan-zw/brundlefly/pull-request-summary/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.
The block is bundled here and requires no sibling Skill installation.

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.