Add §26 and widen §25 to cover copy that describes itself - #290
Closed
jkhereford wants to merge 1 commit into
Closed
jkhereford wants to merge 1 commit into
jkhereford wants to merge 1 commit into
Conversation
Two tells survive a full pass of the current patterns because they are a stance toward the reader, not a word choice or a rhythm. §26 is new. Copy explains its own legend, layout or navigation to a reader who can already see it. §25 widens from the previous version to the document itself, so it also covers narration of how the text was assembled or sourced. A source credit the reader can follow stays. A description of the process goes. §20 gains one pair for a heading written for effect instead of naming its section, alongside the existing typography examples. README tables, section title and version history updated. Package validates at 3.1.0 and SKILL.md is 396 lines.
Owner
|
Thank you. This was a real gap. I folded it into 3.1.0 in #294 with you as co-author: §25 is now "Writing about the document instead of its subject" and includes your method-narration example, and §20 covers headings written for effect. #271 had just taken §26, and explaining a page's own conventions is the same habit as the widened §25, so it went into §25's watch list instead of getting a new number. |
pull Bot
pushed a commit
to jinzaizhichi/humanizer
that referenced
this pull request
Sep 28, 2026
…tector non-goal §25 now covers text that narrates its own sourcing, assembly, or visible layout, not only what it replaced. This takes the right parts of blader#290: the §25 widening, its method-narration example, and the heading-for-effect case in §20. The proposed §26 (explaining the page's own conventions) is the same habit, so it lives in §25's watch list instead of a new number. §2 gains "That distinction matters." (blader#277). The README says plainly that defeating AI detectors is not a goal (blader#229, blader#281). Co-authored-by: jkhereford <106270503+jkhereford@users.noreply.github.com> Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HDoiHhLbAaQS6XrPbBDisu
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
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.
Two tells survive a full pass of the current 25 patterns, because they are a stance toward the reader rather than a word choice or a rhythm.
We hit this on a page that had already been through the skill and was reported clean. A reader then found nine instances by hand and said, plainly, that people do not talk that way. Every one of them was the writer standing beside the reader explaining the document, instead of telling them the thing.
What this changes
§26, new: explaining the document's own conventions. Copy describes its own legend, layout, order or navigation to a reader who can already see it. "The table below compares", "this section is organized by owner", "ratings are out of five, where five is best". Marked weak alone, since a real writer sometimes needs to state a convention.
§25, widened: from the previous version to the document itself. The existing pattern rejects writing about what the text replaced. The same habit produces writing about how the text was assembled or sourced: "generated from", "compiled from", "narrowed down from", "anything unconfirmed is flagged rather than guessed". The heading changes from "Writing about the previous version" to "Writing about the document instead of its subject", and the problem statement draws the line that matters in practice. A source credit the reader can follow stays. A description of your process goes. A caveat stays where it changes what the reader should do and goes where it only reports how carefully you worked.
§20, one added pair. A heading written for effect instead of naming its section, next to the existing title-case and emoji examples. "## The decision, on one screen" becomes "## How the six options compare". This is heading content rather than heading typography, so it sits with the decoration rather than earning its own number.
Why not fold §26 into an existing pattern
Per AGENTS.md I looked for a home first. §24 is closest and does not fit: it covers a heading echoed by the sentence under it, which is repetition, while this is a description of the page's mechanics. §19 and §20 are about decoration applied to real content. §23 covers disclaimers about what the writer could not find, which is adjacent but about sources rather than layout. §25 was the better fit for the method-narration half, which is why that half is a widening and not a new number.
Checks
python3 scripts/validate-package.pypasses at 3.1.0.claude-plugin/plugin.json