{"slug":"pr","title":"pr","summary":"The shape of a pull request body: a summary diagram, before/after evidence, and merge danger. Use when opening a PR, writing or rewriting a PR description, or when another flow needs a PR body.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-23T17:42:28.190727Z","repo":{"url":"https://github.com/svyatov/supermatt","stars":25,"forks":7,"license":"MIT","updatedAt":"2026-11-11T09:34:49Z"},"bodyHtml":"<hr>\n<h2>name: pr\ndescription: \"The shape of a pull request body: a summary diagram, before/after evidence, and merge danger. Use when opening a PR, writing or rewriting a PR description, or when another flow needs a PR body.\"\nmetadata:\ncredits-skill: show-me\ncredits-author: Dex Horthy\ncredits-organisation: Humanlayer\ncredits-url: \"https://github.com/humanlayer/skills/tree/main/plugins/show-me/skills/show-me\"\nlicense: MIT</h2>\n<p>Use this template for writing the PR body:</p>\n<pre><code>## Summary\n\n&lt;diagram, diff-sketch, or tree&gt;\n\n## Evidence\n\n- **Before:** &lt;screenshot/output/failing test run&gt;\n  **After:** &lt;screenshot/output/passing test run&gt;\n\n## Merge danger\n\n**Door:** &lt;one-way or two-way&gt;\n\n&lt;optional: description&gt;\n\n**Blast radius:** &lt;one-word description&gt;\n\n&lt;optional: potential ramifications of merge&gt;\n</code></pre>\n<h2>Sections</h2>\n<p>Skip all preambles and keep prose brief. Use the user's domain language from the glossary (<code>docs/agents/domain.md</code> gives the layout; by default <code>GLOSSARY.md</code>).</p>\n<h3>Summary</h3>\n<p>Pick the smallest view that makes the key point clear.</p>\n<ul>\n<li>Show logic or an algorithm as pseudocode:</li>\n</ul>\n<pre><code>on(save)\n  if content is unchanged\n    return cached result\n  write new content\n  return fresh result\n</code></pre>\n<ul>\n<li>Show runtime control flow as a call tree:</li>\n</ul>\n<pre><code>submitForm\n  createSession\n    persistPrompt\n    launchAgent\n  navigateToSession\n</code></pre>\n<ul>\n<li>Show UI structure as a component tree, including state and module boundaries that matter:</li>\n</ul>\n<pre><code>&lt;SessionPage&gt;            // apps/example/src/routes/session.tsx\n  useSessionEvents()\n  &lt;SessionToolbar&gt;\n    &lt;RunSkillButton /&gt;   // packages/ui\n</code></pre>\n<ul>\n<li>Show file responsibility or a broad refactor as a shallow file tree:</li>\n</ul>\n<pre><code>src/\n├── commands/       # parses user actions\n├── sessions/       # owns session state\n└── transport/      # sends API requests\n</code></pre>\n<ul>\n<li>Show component interaction, control flow, or data flow with Mermaid:</li>\n</ul>\n<pre>sequenceDiagram\n    participant User\n    participant UI\n    participant Daemon\n    User-&gt;&gt;UI: choose command\n    UI-&gt;&gt;Daemon: send expanded prompt\n    Daemon--&gt;&gt;UI: stream result\n</pre>\n<ul>\n<li>Use <code>diff</code> when the point is what changes and the surrounding shape already exists. Match the diff shape to the topic.</li>\n</ul>\n<p>For a component change:</p>\n<pre><code> &lt;SessionPage&gt;\n   useSessionEvents()\n   &lt;SessionToolbar&gt;\n+    &lt;RunSkillButton /&gt;\n   &lt;SessionTimeline&gt;\n+    &lt;SkillResultCard /&gt;\n</code></pre>\n<p>For a file-layout change:</p>\n<pre><code> src/\n ├── commands/\n+│   └── show-me.ts       # expands the slash command\n ├── sessions/\n-└── transport.ts\n+└── transport/\n+    ├── client.ts\n+    └── stream.ts\n</code></pre>\n<p>For a call-tree or call-stack change:</p>\n<pre><code> submitForm\n   createSession\n     persistPrompt\n+    expandSkillMention\n     launchAgent\n-  navigateToSession\n+  navigateToSession\n+    subscribeToEvents\n</code></pre>\n<p>For a state or control-flow change:</p>\n<pre><code> on(save)\n-  write content\n+  if content is unchanged\n+    return cached result\n+  write new content\n+  invalidate cache\n</code></pre>\n<ul>\n<li>Show the whole block when most of it is new, when omitted context would hide ownership or order, or when the user needs a copyable target shape:</li>\n</ul>\n<pre><code>function expandSkill(command: string): string {\n  const skillName = command.slice(1);\n  return `use the ${skillName} skill`;\n}\n</code></pre>\n<h4>Guidance</h4>\n<p>Place each visual next to the short text it supports. Keep only the calls, files, props, states, and boundaries a reviewer needs to understand the change.</p>\n<p>You may use one of these, you may use several, it is unlikely you will use all of them. Use your judgement and don't overwhelm the user.</p>\n<h3>Evidence</h3>\n<p>Concrete evidence that the change works. Show a before and after when both were captured. For a rewrite, preserve the supplied evidence and its limits; rewriting the description does not establish that checks ran. If a before state or executable check is unavailable or not applicable, say which evidence is missing and why, report only observed results, and leave the verification gap explicit.</p>\n<p>Screenshots are S-tier, when the environment is set up for it and the change is visual.</p>\n<p>Execution-based evidence is A-tier. Report the actual test commands, results, and checked revision. A failing-before/passing-after claim needs observations of both runs. Pseudocode may explain the tested behavior when labeled illustrative; it is not an executed test or proof of a result.</p>\n<h3>Merge danger</h3>\n<p>Describe whether it's a one-way or two-way door. You can walk back through two-way doors, but not one-way doors. A PR that is cheap to roll back is lower risk. Changes that involve destructive actions or hard-to-reverse decisions are one-way doors.</p>\n<p>The blast radius is the potential impact or scope of the changes introduced by this PR. Consider all possibilities. Examples are layout shift, breakages for consumers, mobile responsiveness, etc.</p>\n","files":[{"path":"agents/openai.yaml","sizeBytes":104,"isText":true},{"path":"CREDITS.md","sizeBytes":595,"isText":true},{"path":"NOTICE","sizeBytes":1154,"isText":false},{"path":"SKILL.md","sizeBytes":4865,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-23T17:43:03.299996Z","sha256":"7C3785D75727DF2CF11065A8CC98563BAE44EBD4BD69B63C33B5ACBFC2A19CFC","sizeBytes":3758},"review":null,"source":{"repositoryUrl":"https://github.com/svyatov/supermatt","path":"skills/pr","license":"MIT","commit":"58dabace448725e473477545bead7633bd496274","subtreeSha":"5C03398C89FFC1C685EE69788B26E22BD4F89DA1E9FA71CD1E8BE026B6237A49","lastSyncedAt":"2026-11-12T21:44:49.836164Z"},"reviewedAt":"2026-10-23T17:44:02.393858Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/svyatov/supermatt/tree/main/skills/pr"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install svyatov-supermatt@llmmart"},{"target":"git","command":"git clone https://github.com/svyatov/supermatt.git"}]}