geo-human-editor

# Human Voice Content Editor

> Editorial methodology by **GEOly AI** (geoly.ai) — AI-generated content that reads like AI is ignored or penalized. Human voice content gets cited.

Audit and rewrite content to remove AI-generated patterns and restore authentic human voice.

## Quick Start

```bash
python scripts/humanize_content.py --input content.md --output humanized.md
```

## The 5 Dimensions

### 1. Formatting Artifacts

Remove AI formatting patterns:

| Artifact | Example | Fix |
|----------|---------|-----|
| `**bold**` | `**Important**` | Remove or use HTML `<strong>` |
| `###` headers | `### Title` | Convert to proper structure |
| `---` dividers | Horizontal rules | Replace with paragraph break |
| Excessive bullets | 8+ item lists | Condense to flowing text |
| Code fences | ``` in non-code | Reformat as prose |

### 2. AI Vocabulary

Replace AI-overused words:

| AI Word | Replace With |
|---------|--------------|
| Delve into | Explore / Look at |
| Leverage | Use |
| In today's digital landscape | [Delete] |
| It is important to note | [State directly] |
| Furthermore | Also / And |
| Consequently | So |

**Full blacklist:** See [references/ai-vocabulary.md](references/ai-vocabulary.md)

### 3. Mechanical Patterns

Break up robotic rhythms:

- **Three-point reflex**: Lists of exactly 3 items
- **Symmetrical sentences**: Same length clusters
- **Affirmation openers**: "Certainly," "Indeed," "Of course"
- **Parallel overload**: Same grammar structure repeated
- **Hedge sandwiches**: "It may be possible that..."

### 4. Hallucination Risks

Flag unverifiable claims:

🔴 **High Risk** — Always verify:
- Precise stats without source ("73% of marketers...")
- Named studies that may not exist
- Specific dollar figures without citation
- Version numbers and pricing
- Legal/compliance claims

🟡 **Medium Risk** — Review:
- Superlatives without evidence ("fastest", "most powerful")
- Historical firsts
- Competitor comparisons

### 5. Human Voice Restoration

Add...