Repository navigation
claude-attribution: Block quote Claude-drafted text - #26
Merged
Merged
Conversation
A reviewer on Gutenberg#81397 could not tell whether a reply was Adam's own take or Claude's output, and asked for the generated text to be set apart so he knows when he is talking to a person. An italic header alone labels only the first line - the body still runs flush against Adam's writing. Require a block quote around the whole drafted response, keep Adam's own words at the left margin, and lead with a line in his voice where there is one to write so the thread stays a conversation. Add quoting mechanics for code blocks, nested quotes, and Trac, and rewrite the examples as raw markdown so the quoting is visible.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Makes it obvious where Claude's words start and stop in anything posted under Adam's name. The drafted response now goes inside a block quote; Adam's own words stay at the left margin.
Before, the only marker was an italic header line, which labels the first line and leaves the rest of the response running flush against Adam's own writing.
Why
From a review on WordPress/gutenberg#81397:
Two things in that: a visible boundary, and the sense that a person is still in the conversation. The block quote handles the first. For the second, the skill now asks for a line in Adam's own voice above the header - his take, his question, or his next step - so a comment isn't purely relayed machine output.
Changes
claude-attribution: new "Shape of an attributed comment" and "Block quote mechanics" sections (code fences inside quotes, no nested> >, Trac's identical>syntax,<details>for very long output). Block quoting is a non-negotiable. Examples rewritten as raw markdown so the quoting is visible. Four new anti-patterns, and the short-reply exemption now turns on who wrote the words rather than length alone.adams-voice: attribution section and examples updated to match.README.md: skill description updated.AI Use
Claude Code drafted this and I steered. I will review and test.