Repository navigation
Rewrite unclear sentences in the skill and README - #330
Merged
Merged
Conversation
Name who acts in passive and subjectless lines, replace coined terms
("riders", "shape edits", "by rule instead of by ear", "send-off",
"dressing") with plain words, and cut sentences that only announced or
repeated a neighbor. Step 3 now checks for added or dropped facts
first, and pattern 26 gives its instruction second instead of third.
Pattern 15 is renamed "Shallow -ing phrases". The README gives
/humanizer as the only command. No pattern was added, removed, or
renumbered. SKILL.md goes from 5,316 to 5,327 words.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MfuoZmv32PFqiaYKaAVSFc
The pattern descriptions are about text, so the text is a fine subject. Restore the original Problem lines and "Why" bullets, and keep the plain-word replacements, the cut sentences, and the reordered step 3 and pattern 26. In pattern 7 the unclear cause clause is dropped instead of rewritten. SKILL.md is now 5,298 words, down from 5,316. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MfuoZmv32PFqiaYKaAVSFc
This was referenced Nov 10, 2026
Merged
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.
Why
Zonder Labs' write-up on AI slop names faults that make text hard to read. Two of them showed up in
SKILL.mdandREADME.md: wording that is vague or coined, and sentences that bury the point or say nothing. An agent reads every word ofSKILL.mdon each use, so an unclear line there costs something every time.What changed
Wording only, in the prose of
SKILL.mdandREADME.md. No pattern was added, removed, or renumbered. Users get the new wording the next time they install or sync the skill. The version stays 3.1.0, with a note under Unreleased inCHANGELOG.md.Coined terms became plain words. Three were unclear enough that I recovered their meaning from the commits that introduced them (
34ca949andeda497e):"Riders", "the move", and "send-off" are gone too. Pattern 15 is renamed from "Shallow -ing riders" to "Shallow -ing phrases" in both files.
Sentences that announced or repeated are cut, and two late points moved up.
README. Three sentences now say what Humanizer does: it does not try to get past AI detectors, it may merge, split, or reorder sentences while drafting, and it numbers the patterns from strongest to weakest. The install section gives
/humanizeras the only command and no longer lists/humanizer:humanizeror/skill:humanizer.SKILL.mdgoes from 5,316 to 5,298 words, under the 5,500 cap.An earlier commit on this branch also rewrote passive pattern descriptions to start with "The writer". The second commit takes that back out: the descriptions are about text, so the text is a fine subject.
What to decide
These are changes to a prompt, and I did not run a model eval on them. The reviewer decides whether each rewrite keeps its rule's meaning. Three lines deserve the closest read, because they changed order or dropped a clause: step 3 in "How to work", the Problem line of pattern 7, and the Problem line of pattern 26.
Validation
python3 scripts/validate-package.py,npx --yes skills@1.5.20 add . --list, andclaude plugin validate .pass.To check it, read the diff of
SKILL.md. It changes 11 lines, and each is a sentence replaced or removed in place.#318 edits some of the same lines and will need a rebase after this merges.
🤖 Generated with Claude Code
https://claude.ai/code/session_01MfuoZmv32PFqiaYKaAVSFc