Add optional Positive Voice Guide section#99
Open
adelaidasofia wants to merge 1 commit intoblader:mainfrom
Open
Add optional Positive Voice Guide section#99adelaidasofia wants to merge 1 commit intoblader:mainfrom
adelaidasofia wants to merge 1 commit intoblader:mainfrom
Conversation
Voice Calibration teaches voice by example (a writing sample). This adds a complementary mechanism: voice by description (a guide that states the writer's positive principles, hook patterns, audience routing, and concrete anti-examples). Without a positive guide, even a clean rewrite can land flat: generic-human, not the writer's specific human. The guide acts as the rewrite's North Star after AI tells are stripped. Optional and self-contained. If no guide is provided, the existing Voice Calibration / PERSONALITY AND SOUL fallbacks run unchanged.
spencergoldade
added a commit
to spencergoldade/humanizer
that referenced
this pull request
Apr 22, 2026
Upstream blader/humanizer PR blader#99 (adelaidasofia). Pure additive. Inserts between Voice Calibration and PERSONALITY AND SOUL. Gives the rewrite a pull-toward anchor (explicit voice rules the writer maintains) on top of the existing voice-calibration sample mechanism. Author reports the measurable win is on "clean but generic" rewrites. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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
Adds a new optional section, Positive Voice Guide, right after the existing Voice Calibration (Optional) section in
SKILL.md. +20 lines, no deletions.Why
Voice Calibration teaches voice by example (a writing sample). I've found in heavy use that examples alone leave gaps: humanizer strips AI tells well but the result still lands generic-human, not the writer's specific human. Especially when the prose is right for one surface but wrong for another (e.g. journal vocabulary on a business surface), a sample doesn't catch it.
A positive voice guide teaches voice by description: a small file the writer maintains with their positive principles, hook patterns, audience routing (different vocabulary for different surfaces), and concrete anti-examples. That gives the rewrite a North Star after the AI tells are stripped.
The two are complementary, not competing. Sample = pattern data. Guide = explicit rules. Both feed the rewrite.
How
Optional and self-contained:
voice-style.mdat project root), humanizer reads it before rewriting and uses it as a quality check on each paragraph.No existing behavior changes for users who don't have a voice guide.
Notes
SKILL.md. The core idea is small; everything past the first paragraph is just usage detail.