Humanizer: remove AI writing patterns

Statistical signals

Beyond pattern matching, check for these AI statistical tells:

Vocabulary tiers

• Tier 1 (Dead giveaways): delve, tapestry, vibrant, crucial, comprehensive, meticulous, embark, robust, seamless, groundbreaking, leverage, synergy, transformative, paramount, multifaceted, myriad, cornerstone, reimagine, empower, catalyst, invaluable, bustling, nestled, realm
• Tier 2 (Suspicious in density): furthermore, moreover, paradigm, holistic, utilize, facilitate, nuanced, illuminate, encompasses, catalyze, proactive, ubiquitous, quintessential
• Phrases: "In today's digital age", "It is worth noting", "plays a crucial role", "serves as a testament", "in the realm of", "delve into", "harness the power of", "embark on a journey", "without further ado"

Core principles

Write like a human, not a press release

• Use "is" and "has" freely — "serves as" is pretentious
• One qualifier per claim — don't stack hedges
• Name your sources or drop the claim
• End with something specific, not "the future looks bright"

Add personality

• Have opinions. React to facts, don't just report them
• Vary sentence rhythm. Short. Then longer ones that meander.
• Acknowledge complexity and mixed feelings
• Let some mess in — perfect structure feels algorithmic

Cut the fat

• "In order to" → "to"
• "Due to the fact that" → "because"
• "It is important to note that" → (just say it)
• Remove chatbot filler: "I hope this helps!", "Great question!"

Before/after example

Before (AI-sounding):

Great question! Here is an overview of sustainable energy. Sustainable energy serves as an enduring testament to humanity's commitment to environmental stewardship, marking a pivotal moment in the evolution of global energy policy. In today's rapidly evolving landscape, these groundbreaking technologies are reshaping how nations approach energy production, underscoring their vital role in combating climate change. The future looks bright. I hope this helps!

After (human):

Solar panel costs dropped 90% between 2010 and 2023, according to IRENA data. That single fact explains why adoption took off — it stopped being an ideological choice and became an economic one. Germany gets 46% of its electricity from renewables now. The transition is happening, but it's messy and uneven, and the storage problem is still mostly unsolved.

Using the analyzer

# Score text (0-100, higher = more AI-like)
echo "Your text here" | node src/cli.js score

# Full analysis report
node src/cli.js analyze -f draft.md

# Markdown report
node src/cli.js report article.txt > report.md

# Suggestions grouped by priority
node src/cli.js suggest essay.txt

# Statistical analysis only
node src/cli.js stats essay.txt

# Humanization suggestions with auto-fixes
node src/cli.js humanize --autofix -f article.txt

# JSON output for programmatic use
node src/cli.js analyze --json < input.txt

Always-on mode

For agents that should ALWAYS write like a human (not just when asked to humanize), add the core rules to your personality/system prompt. See the README's "Always-On Mode" section for copy-paste templates for OpenClaw (SOUL.md), Claude, and ChatGPT.

The key rules to internalize:

• Ban Tier 1 vocabulary (delve, tapestry, vibrant, crucial, robust, seamless, etc.)
• Kill filler phrases ("In order to" → "to", "Due to the fact that" → "because")
• No sycophancy, chatbot artifacts, or generic conclusions
• Vary sentence length, have opinions, use concrete specifics
• If you wouldn't say it in conversation, don't write it

Process

1. Read the input text
2. Run pattern detection (24 patterns, 500+ vocabulary terms)
3. Compute text statistics (burstiness, TTR, readability)
4. Identify all issues and generate suggestions
5. Rewrite problematic sections
6. Verify the result sounds natural when read aloud
7. Present the humanized version with a brief change summary