Humanizer Enhanced

metadata:
  version: 1.2.0
  author: 0G Labs content team
---

# Humanizer enhanced: remove AI writing patterns

Identify and remove signs of AI-generated text. This enhanced version includes crypto/Web3 patterns and adds personality to make content sound genuinely human-written.

## Quick start

```text
/humanizer                    # Humanize current file or selection
/humanizer path/to/file.md    # Humanize specific file
/humanizer --scan             # Scan only, don't edit (show issues)
/humanizer --batch drafts/    # Process all .md files in directory
```

---

## Process

### Step 1: Scan for patterns

Identify all AI patterns in the text, categorize by severity:

- **HIGH** — Obvious AI tells, must fix (negative parallelism, chatbot artifacts, em dash overuse, vague attributions, copula avoidance)
- **MEDIUM** — Common AI patterns, should fix (rule of three, significance inflation, synonym cycling)
- **LOW** — Minor tells, fix if time permits (title case headings, excessive bold)

### Step 2: Report findings

Show user a summary:

```text
## Humanizer scan results

HIGH (3 issues)
- Line 45: Negative parallelism "isn't X. It's Y"
- Line 89: Em dash overuse (5 instances)
- Line 120: "Research shows" without attribution

MEDIUM (5 issues)
- Line 23: Rule of three pattern
- Line 67: Copula avoidance "serves as"
...

LOW (2 issues)
- Line 12: Title case heading
...

Total: 10 issues found
Estimated humanization: ~15 edits needed
```

### Step 3: Fix (with user approval)

Ask user: "Fix all issues? Or review one by one?"

### Step 4: Add soul

After fixing patterns, review for personality. Sterile writing is still obvious AI. See `references/communication-crypto-soul-patterns.md` for the full soul/personality guide.

### Step 5: Readability check

Check Flesch-Kincaid readability. Target grade 10-12 for developer content, grade 8-10 for general audience. If score is too high (too complex), simplify longest sentences and replace jargon.

### Step 6: Em dash regression scan

After all other fixes, run a final check for em dashes (—) across the text. Humanizer rewrites can reintroduce em dashes. Remove any that were added during the fix process.

---

## Pattern routing table

All 34 patterns are documented with before/after examples in the reference files below.

| Patterns | Severity | Reference file |
|----------|----------|----------------|
| 1. Significance inflation | MEDIUM | `references/content-patterns.md` |
| 2. Promotional language | MEDIUM | `references/content-patterns.md` |
| 3. Superficial -ing analyses | MEDIUM | `references/content-patterns.md` |
| 4. Vague attributions | HIGH | `references/content-patterns.md` |
| 5. Formulaic challenges sections | MEDIUM | `references/content-patterns.md` |
| 6. Generic positive conclusions | MEDIUM | `references/content-patterns.md` |
| 7. AI vocabulary words | MEDIUM | `references/language-style-patterns.md` |
| 8. Copula avoidance | HIGH | `references/language-style-patterns.md` |
| 9. Negative parallelism | HIGH | `references/language-style-patterns.md` |
| 10. Rule of three | MEDIUM | `references/language-style-patterns.md` |
| 11. Synonym cycling | MEDIUM | `references/language-style-patterns.md` |
| 12. False ranges | LOW | `references/language-style-patterns.md` |
| 13. Em dash overuse | HIGH | `references/language-style-patterns.md` |
| 14. Excessive boldface | LOW | `references/language-style-patterns.md` |
| 15. Inline-header lists | MEDIUM | `references/language-style-patterns.md` |
| 16. Title case headings | LOW | `references/language-style-patterns.md` |
| 17. Curly quotes | LOW | `references/language-style-patterns.md` |
| 18. Chatbot artifacts | HIGH | `references/communication-crypto-soul-patterns.md` |
| 19. Knowledge cutoff disclaimers | HIGH | `references/communication-crypto-soul-patterns.md` |
| 20. Sycophantic tone | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 21. Excessive hedging | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 22. Filler phrases | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 23. Crypto hype language | HIGH | `references/communication-crypto-soul-patterns.md` |
| 24. Vague "ecosystem" claims | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 25. Unsubstantiated stats | HIGH | `references/communication-crypto-soul-patterns.md` |
| 26. "Seamless" and "frictionless" | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 27. Abstract "empowerment" language | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 28. Fake decentralization claims | HIGH | `references/communication-crypto-soul-patterns.md` |
| 29. Meta-narration | HIGH | `references/communication-crypto-soul-patterns.md` |
| 30. False audience range | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 31. Parenthetical definitions | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 32. Sequential numbering | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 33. "It's worth noting" filler | MEDIUM | `references/communication-crypto-soul-patterns.md` |
| 34. Identical paragraph structure | HIGH | `references/communication-crypto-soul-patterns.md` |
| Soul and personality guide | — | `references/communication-crypto-soul-patterns.md` |

---

## Severity reference

| Severity | Patterns | Action |
|----------|----------|--------|
| HIGH | Negative parallelism, em dash overuse, chatbot artifacts, vague attributions, copula avoidance, crypto hype, unsubstantiated stats, meta-narration, identical paragraph structure, fake decentralization, knowledge cutoff disclaimers | Must fix |
| MEDIUM | Rule of three, significance inflation, promotional language, -ing analyses, AI vocabulary, sycophantic tone, hedging, filler phrases, ecosystem claims, false audience range, parenthetical definitions, sequential numbering, "it's worth noting" filler, inline-header lists, "seamless"/"frictionless", abstract empowerment | Should fix |
| LOW | Title case, curly quotes, excessive bold, false ranges | Fix if time permits |

---

## Quick reference: find and replace

| Find | Replace |
|------|---------|
| `—` (em dash, multiple) | `, ` or `. ` |
| `serves as` / `stands as` | `is` |
| `isn't X. It's Y` | Rewrite as single statement |
| `crucial` / `vital` / `pivotal` | `important` or `key` or delete |
| `Furthermore,` / `Moreover,` | `Also,` or delete |
| `It is important to note` | Delete |
| `Research shows` | Add specific source |
| `landscape` (abstract) | Be specific |
| `revolutionizing` / `game-changing` | Describe what it actually does |
| `seamless` / `frictionless` | Describe the actual UX |
| `In this article, we'll explore` | Delete |
| `Let's dive in` / `Let's take a look` | Delete |
| `First,... Second,... Third,...` | Vary transitions |
| `It's worth noting` / `Notably,` | Delete |
| `delve` | "look at" / "examine" |
| `Additionally` | Delete |

---

## Batch mode

To humanize multiple files:

```bash
# Scan all markdown files in drafts/
/humanizer --scan drafts/*.md

# Fix all files (with confirmation)
/humanizer --batch drafts/
```

Output format for batch:

```text
## Batch humanization report

drafts/post-1.md
   HIGH 3 | MEDIUM 5 | LOW 2

drafts/post-2.md
   HIGH 1 | MEDIUM 3 | LOW 4

drafts/post-3.md
   Clean! No issues found.

Total: 3 files, 18 issues
```

---

## Sources

Based on:
- [Wikipedia: Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing)
- [GitHub: blader/humanizer](https://github.com/blader/humanizer)
- Original research on crypto/Web3 AI patterns

Key insight: "LLMs use statistical algorithms to guess what should come next. The result tends toward the most statistically likely result that applies to the widest variety of cases."

---

*Version 1.2.0 | Created for 0G Labs content team*