name: "pr-body"
description: "Write or revise a pull request description using the repository's conventions."
createdAt: "2026-09-11T18:46:00.191378+00:00"
repoUrl: "https://skillz.supply/skills/did:plc:xbtmt2zjwlrfegqvch7fboei/skills.pr-body/SKILL.md"
# pr body This skill owns PR prose. Use the available repository workflow for branches, validation, and authorized posting; do not assume another skill is installed. read the host repository's CLAUDE.md/AGENTS.md and PR template first; they win. ## shape 1. punchline: one to three sentences. what a reader observes changed, and why. name where the problem was seen when there is a where. 2. evidence that explains faster than prose, when it exists: a snippet in the change's language, a measurement, a log line, a table. 3. `<details>` blocks, each titled for what it holds (design notes, reproduction, security model, what's in it, tests). add only blocks that carry information the diff cannot. 4. the repository's closing conventions: related links, rollout caveats. 5. attribution when required by the user or repository. size follows the change. a two-line change usually needs a punchline and any required attribution. ## voice lowercase, except where uppercase is idiomatic: Proper Nouns, `camelCase`, `PascalCase`, acronyms. a host repository that writes in sentence case wins. ## disclosure Follow the user's or repository's attribution policy. When disclosing agent use, name the actual harness and model. Preserve existing attribution when editing a body or amending a commit. Use a supplied attribution block verbatim; do not invent a session URL or an author email address. ## optional illustration Include a bufo or other closing illustration only if the user or repository requests that convention. For a requested bufo, search https://find-bufo.com/api/search with `q=<mood>&family_friendly=true&top_k=10`, choose one relevant result, and embed its returned URL. Keep attribution in the position required by the repository. ## test before posting read it as the reviewer. every sentence states one fact about the change or its evidence. remove sentences about the writing, the process, or the session. ## gotchas - post from a file (`--body-file`) so backticks and `$` survive the shell. - partner names, Slack context, and internal discussion stay out unless they belong in the public record.