Willison hides AI PR descriptions behind <details><summary>
TL;DR
- Simon Willison wraps the full agent-written PR body in a `
` block and leaves a short human-written opener visible above it.
- The summary tag carries the model name and effort level, e.g. "Claude Opus 5.5 Medium", so reviewers know what they would be expanding.
- GitHub Markdown renders `
` natively, so the pattern works in PR descriptions and issue comments with no extra tooling.
Simon Willison has adopted a small GitHub Markdown trick for the pull requests that Claude Code and Codex now open on his behalf: paste the agent's long write-up inside an HTML `<details><summary>` block, leave a short human-written opener above it, and label the summary tag with the model name. He laid out the pattern on his blog with five recent examples from his datasette and llm projects; two of the practitioners we follow circulated the post the same day.
"An agent-written PR description is accurate and comprehensive," Willison writes. "It describes the problem, the detailed solution, and the steps taken to verify it. That's a lot of information to absorb." His complaint is not about correctness; it is about volume. "It's not necessarily slop, but it reads like slop!"
The fix fits on one line of Markdown. GitHub renders the `<details>` element natively, so the agent's essay collapses behind a clickable summary like "Claude Opus 5.5 Medium" while the reviewer sees only the human-approved intro by default. "A reader can glance at it and get the top, human-curated information without their eyes glazing over," he writes. He closes by asking GitHub to add a toolbar button for the tag pair, partly so more users discover the feature exists.
Shared on Bluesky by 2 AI experts
-
I've recently started hiding the bulk of my AI-generated GitHub PR descriptions behind a collapsed HTML tag (thankfully supported by GitHub Markdown) and I think it's a useful pattern for making PR slop a little bit les…
View on Bluesky →
Originally reported by simonwillison.net
Read the original article →Original headline: Hide your slop PR descriptions behind <details><summary>