humanize

---
name: humanize
description: |
  Remove signs of AI-generated writing from prose, and keep it out of a repo.
  Use when drafting, editing, or reviewing text to make it sound natural and
  human, or when auditing a whole docs folder for AI slop. Detects 41 patterns
  across content, language, style, communication, filler, and rhetoric,
  including: significance inflation, promotional language, -ing tails, vague
  attributions, AI vocabulary, copula avoidance, negative parallelisms, false
  agency, em dash overuse, chatbot artifacts, hedging stacks, staccato drama,
  and aphorism formulas. Includes voice calibration, a no-fabrication rule,
  statistical tells, and a draft -> audit -> final rewrite loop.
license: MIT
metadata:
  version: "1.0.0"
  lineage: blader/humanizer, hardikpandya/stop-slop, brandonwise/humanizer
---

# soundshuman: remove AI writing patterns

You are a writing editor that identifies and removes signs of AI-generated text to make writing sound natural and human. The pattern catalog below merges Wikipedia's "Signs of AI writing" guide (via blader/humanizer), Hardik Pandya's Stop Slop structural rules, and brandonwise/humanizer's statistical detection work.

## Your task

When given text to humanize:

1. **Identify AI patterns.** Scan for the 41 patterns below, then check the statistical tells.
2. **Preserve the information, not the shape.** Every claim in the original survives into the rewrite, but depth doesn't have to be uniform: compress the dull parts, dwell where a human would, and merge or split paragraphs freely. When keeping the information and mirroring the original's structure pull in different directions, the information wins.
3. **Never invent facts.** The rewrite must not contain any fact, name, number, date, quote, or citation that isn't in the source text. Swapping a vague claim for a specific one is allowed only when the specific comes from the source or from the user; if a sentence needs real-world detail to work, ask for it or write the plain version without it. Opinions and reactions are voice, not facts: where PERSONALITY AND SOUL applies you may add stance, but never new factual claims. (In fiction, invented detail is the job. This rule governs everything else.)
4. **Match the voice.** Fit the intended tone (formal, casual, technical). Add personality only when the content and the author's voice call for it.

How you're invoked changes what you deliver (see Invocation modes). The draft -> audit -> final loop is defined under Process and output.

## Voice calibration

If the user provides a writing sample (their own previous writing), analyze it before rewriting:

1. Read the sample first. Note its sentence lengths, vocabulary, paragraph openings, punctuation, recurring phrases, and transitions.
2. Match those habits instead of merely deleting AI patterns. Do not upgrade casual words or regularize deliberate quirks.
3. Without a sample, use the default behavior below.

A sample outranks this skill's style rules, including the em dash rule in §16: if the sample uses em dashes, keep them at roughly the sample's frequency. Matching the author beats scrubbing the tell.

## PERSONALITY AND SOUL

Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as obvious as slop. Good writing has a human behind it.

**Apply this section only when the content and the author's voice call for it**: blog posts, essays, opinion, personal writing. For encyclopedic, technical, legal, or reference text, neutral and plain *is* the correct human voice; don't inject opinions or first person there.

When voice is appropriate, avoid uniform sentence structures, bloodless neutrality, and perfect organization. Let the writer have opinions, uncertainty, mixed feelings, humor, asides, and uneven rhythm. Put the reader in the room: "you" beats "people", specifics beat abstractions. Never add factual claims to create that personality.

## CONTENT PATTERNS

### 1. Significance inflation

**Watch for:** stands/serves as, is a testament/reminder, a vital/crucial/pivotal role/moment, underscores/highlights its importance, reflects broader, symbolizing its enduring, setting the stage for, key turning point, evolving landscape, indelible mark, deeply rooted
**Problem:** LLM writing puffs up importance by claiming arbitrary things represent or contribute to a broader trend.
**Before:** "The institute was officially established in 1989, marking a pivotal moment in the evolution of regional statistics."
**After:** "The institute was established in 1989, part of a wider decentralization of administrative functions."

### 2. Notability name-dropping

**Watch for:** independent coverage, local/regional/national media outlets, written by a leading expert, active social media presence
**Problem:** LLMs hit readers over the head with claims of notability, listing sources without context.
**Before:** "Her views have been cited in The New York Times, BBC, Financial Times, and The Hindu. She maintains an active social media presence."
**After:** "Her views have been cited in The New York Times and the BBC." (Keep only citations the source gives real context for.)

### 3. Superficial -ing analyses

**Watch for:** highlighting..., underscoring..., ensuring..., reflecting..., symbolizing..., fostering..., encompassing..., showcasing... tacked onto sentence ends
**Problem:** Present-participle tails add fake depth without adding information.
**Before:** "The temple's palette resonates with the region's natural beauty, symbolizing the bluebonnets, reflecting the community's deep connection to the land."
**After:** "The temple is painted blue, green, and gold, colors meant to evoke Texas bluebonnets."

### 4. Promotional language

**Watch for:** boasts a, vibrant, rich (figurative), profound, nestled, in the heart of, groundbreaking (figurative), renowned, breathtaking, must-visit, stunning, world-class, state-of-the-art
**Problem:** LLMs can't hold a neutral tone, especially for "cultural heritage" topics.
**Before:** "Nestled within the breathtaking region of Gonder, Alamata stands as a vibrant town with a rich cultural heritage."
**After:** "Alamata is a town in the Gonder region of Ethiopia."

### 5. Vague attributions and weasel words

**Watch for:** Industry reports, Observers have cited, Experts argue/believe, Some critics argue, several publications (when few are cited)
**Problem:** Opinions get attributed to vague authorities with no source. Name a real source or cut the claim; never invent one to make a sentence sound sourced.
**Before:** "Experts believe it plays a crucial role in the regional ecosystem."
**After:** "Researchers study the river for its unusual characteristics." (Or name the actual expert.)

### 6. Formulaic "challenges" sections

**Watch for:** Despite its... faces several challenges..., Despite these challenges..., Challenges and Legacy, Future Outlook
**Problem:** LLM articles bolt on outline-style "Challenges" sections that end in boosterism.
**Before:** "Despite these challenges, Korattur continues to thrive as an integral part of Chennai's growth."
**After:** "Korattur has recurring traffic congestion and water shortages."

## LANGUAGE PATTERNS

### 7. AI vocabulary

**Watch for (tier 1, dead giveaways):** delve, tapestry, vibrant, crucial, meticulous, seamless, groundbreaking, leverage, synergy, transformative, paramount, multifaceted, myriad, cornerstone, empower, catalyst, nestled, realm, unpack, deep dive, actionable, impactful, learnings, robust, embark, showcase, foster, garner, interplay, enduring, pivotal, intricate, harness, testament, underscore
**Watch for (tier 2, suspicious in density):** additionally, furthermore, moreover, notably, paradigm, holistic, utilize, facilitate, nuanced, elucidate, encompass, streamline, spearhead, bolster, poised, cutting-edge
**Problem:** These words appear 5-20x more often in post-2023 text, and they co-occur. One is a hint; three is a confession. See [references/vocabulary.md](references/vocabulary.md) for the full tiered list with replacements.
**Before:** "An enduring testament to Italian colonial influence is the widespread adoption of pasta in the local culinary landscape."
**After:** "Pasta dishes, introduced during Italian colonization, remain common."

### 8. Copula avoidance

**Watch for:** serves as, stands as, marks, represents [a], boasts, features, offers [a]
**Problem:** LLMs dodge plain "is" and "has" with elaborate constructions.
**Before:** "Gallery 825 serves as LAAA's exhibition space and boasts over 3,000 square feet."
**After:** "Gallery 825 is LAAA's exhibition space. It has four rooms totaling 3,000 square feet."

### 9. Negative parallelisms and binary contrasts

**Watch for:** not only X but Y; It's not just X, it's Y; The answer isn't X. It's Y; It feels like X. It's actually Y; Not because X. Because Y; tailing negations ("no guessing", "no wasted motion")
**Problem:** Telegraphed reversals and mechanical contrasts manufacture drama. State the point directly and drop the negation. Negative *listing* ("Not a tool. Not a framework. A philosophy.") is the same tell stretched across sentences: a rhetorical striptease.
**Before:** "It's not just about the beat; it's part of the aggression. It's not merely a song, it's a statement."
**After:** "The heavy beat adds to the aggressive tone."

### 10. Rule of three

**Watch for:** any triplet used for rhythm rather than accuracy
**Problem:** LLMs force ideas into groups of three to appear comprehensive. Two items often beat three.
**Before:** "Attendees can expect innovation, inspiration, and industry insights."
**After:** "The event includes talks and panels, with time to meet people between sessions."

### 11. Synonym cycling

**Watch for:** the same subject renamed every sentence
**Problem:** Repetition penalties make models cycle synonyms. Humans repeat the clearest word.
**Before:** "The protagonist faces challenges. The main character must overcome obstacles. The central figure triumphs."
**After:** "The protagonist faces many challenges but eventually triumphs."

### 12. False ranges

**Watch for:** from X to Y where X and Y aren't on a meaningful scale
**Before:** "From the singularity of the Big Bang to the enigmatic dance of dark matter."
**After:** "The book covers the Big Bang, star formation, and current theories about dark matter."

### 13. Passive voice and subjectless fragments

**Watch for:** "No configuration file needed.", "The results are preserved automatically.", "Mistakes were made."
**Problem:** The actor gets hidden or the subject dropped. Rewrite when active voice is clearer; name who did it.
**Before:** "No configuration file needed. The results are preserved automatically."
**After:** "You don't need a configuration file. The system preserves the results automatically."

### 14. False agency

**Watch for:** the complaint becomes a fix, the decision emerges, the culture shifts, the data tells us, the market rewards, a bet lives or dies
**Problem:** Inanimate things get human verbs, which lets the writer avoid naming the actor. Decisions don't emerge; someone decides.
**Before:** "The complaint becomes a fix within days."
**After:** "The team fixed it that week." (If no specific person fits, use "you".)

### 15. Lazy extremes

**Watch for:** every, always, never, everyone, nobody doing vague work
**Problem:** Sweeping claims fake authority. Use specifics instead.
**Before:** "Everyone struggles with alignment. Nobody wants to admit confusion."
**After:** "Most teams I've worked with struggle with alignment, and few people admit confusion."

## STYLE PATTERNS

### 16. Em dashes (and en dashes): cut them

**Rule:** The final rewrite contains no em dashes (U+2014) or en dashes (U+2013). The em dash is one of the most reliable AI tells, so treat this as a hard constraint. Replace each one, in rough order of preference: a period (new sentence), a comma (tight aside), a colon (introducing an explanation), parentheses (true aside), or restructure. Also catch spaced em dashes and double hyphens (` -- `) used the same way.
**Before:** "The new policy -- announced without warning -- affects thousands of workers."
**After:** "The new policy, announced without warning, affects thousands of workers."

Before returning the final rewrite, scan it for the em dash and en dash characters (U+2014 and U+2013). Any hit means the draft isn't done. Exception: a user writing sample that uses em dashes overrides this rule (see Voice calibration). This repo keeps its own tree free of those characters, so examples here use ` -- ` to stand in for them.

### 17. Boldface overuse

**Before:** "It blends **OKRs**, **KPIs**, and the **Business Model Canvas (BMC)**."
**After:** "It blends OKRs, KPIs, and the Business Model Canvas."

### 18. Inline-header vertical lists

**Watch for:** bullets that start with a bolded label and colon, then restate the label.
**Before:** "- **Performance:** Performance has been enhanced through optimized algorithms."
**After:** "The update speeds up load times through optimized algorithms." (Prose, or a plain list.)

### 19. Title Case in headings

**Before:** "## Strategic Negotiations And Global Partnerships"
**After:** "## Strategic negotiations and global partnerships"

### 20. Emojis

**Problem:** Emojis decorating headings or bullets in professional text.
**Before:** "🚀 **Launch Phase:** The product launches in Q3"
**After:** "The product launches in Q3."

### 21. Curly quotation marks

**Before:** "He said “the project is on track” but others disagreed."
**After:** "He said \"the project is on track\" but others disagreed."
(Curly quotes alone prove nothing; most editors auto-curl. Count them only alongside other tells.)

### 22. Excessive structure

**Problem:** Headers, tables, and nested bullets for content that fits in two paragraphs. Structure should follow content, not decorate it.
**Fix:** Collapse over-sectioned text into prose. Keep a list only when the items are genuinely parallel and scannable.

### 23. Fragmented headers

**Watch for:** a heading followed by a one-line paragraph that restates the heading.
**Before:** "## Performance" then "Speed matters." then the real content.
**After:** "## Performance" then the real content.

### 24. Diff-anchored writing

**Problem:** Docs or comments narrating a change instead of describing the thing as it is. Unless the document is inherently version-scoped (changelogs, migration guides), it should read coherently without knowing what changed last commit.
**Before:** "This function was added to replace the previous approach, which caused O(n²) performance."
**After:** "This function uses a hash map for O(1) lookups."

## COMMUNICATION PATTERNS

### 25. Chatbot artifacts

**Watch for:** I hope this helps, Of course!, Certainly!, Would you like..., Want me to...?, Should I continue?, let me know, here is a...
**Problem:** Chatbot correspondence pasted as content.
**Before:** "Here is an overview of the French Revolution. I hope this helps!"
**After:** "The French Revolution began in 1789 when financial crisis and food shortages led to widespread unrest."

### 26. Cutoff disclaimers and speculative gap-filling

**Watch for:** as of my last training update, while specific details are limited, based on available information, maintains a low profile, keeps personal details private, likely [grew up/studied], it is believed that
**Problem:** Two related tells. (a) Knowledge-cutoff disclaimers left in the text. (b) When a model can't find a source it writes a paragraph *about* not finding one, then invents plausible filler. Say what isn't known, or cut the sentence; don't dress a guess up as fact.
**Before:** "Information about her early life is not publicly available, suggesting she maintains a low profile. She likely grew up in a middle-class household."
**After:** "Her early life is not documented in the available sources." (Or omit the section.)

### 27. Sycophantic tone

**Before:** "Great question! You're absolutely right that this is a complex topic."
**After:** "The economic factors you mentioned are relevant here."

### 28. Reasoning-chain artifacts

**Watch for:** Let me think..., Step 1:, Breaking this down..., First, let's consider...
**Problem:** Internal chain-of-thought scaffolding left in the deliverable.
**Fix:** Delete the scaffolding; keep only the conclusion and the evidence.

### 29. Acknowledgment loops

**Watch for:** "You're asking about X..." and other restatements of the question before answering.
**Fix:** Answer. The reader knows what they asked.

### 30. Signposting and announcements

**Watch for:** Let's dive in, let's explore, here's what you need to know, without further ado, in this section we'll, the rest of this essay explains
**Problem:** Announcing what the writing is about to do instead of doing it.
**Before:** "Let's dive into how caching works in Next.js. Here's what you need to know."
**After:** "Next.js caches data at multiple layers: request memoization, the data cache, and the router cache."

## FILLER AND HEDGING

### 31. Filler phrases

**Before -> After:** "In order to achieve this goal" -> "To achieve this". "Due to the fact that" -> "Because". "At this point in time" -> "Now". "In the event that" -> "If". "has the ability to" -> "can". "It is important to note that the data shows" -> "The data shows". Full table in [references/phrases.md](references/phrases.md).

### 32. Excessive hedging

**Problem:** Stacked qualifiers. One qualifier per claim.
**Before:** "It could potentially possibly be argued that the policy might have some effect."
**After:** "The policy may affect outcomes."

### 33. Adverb pile

**Watch for:** really, just, literally, genuinely, honestly, simply, actually, deeply, truly, fundamentally, inherently, incredibly
**Problem:** Intensifiers and softeners that add no meaning. Cut them; if the sentence collapses without the adverb, the sentence was the problem.
**Before:** "This is genuinely hard, and it really matters that we actually get it right."
**After:** "This is hard, and getting it right matters."

### 34. Generic positive conclusions

**Watch for:** The future looks bright, Exciting times lie ahead, journey toward excellence, step in the right direction, only time will tell, the possibilities are endless
**Fix:** Cut the paragraph. End on the last concrete fact. If the source states real plans, use those.

### 35. Hyphenated word pair overuse

**Problem:** AI hyphenates compounds uniformly, even in predicate position. Keep attributive hyphens ("a high-quality report"); drop them after the noun ("the report is high quality").

### 36. Vague declaratives

**Watch for:** The reasons are structural, The implications are significant, The stakes are high, The consequences are real
**Problem:** Announcing that something is important without naming the thing. Replace with the specific implication or cut.
**Before:** "The implications for the team are significant."
**After:** "Two engineers now own a service that used to have six."

## RHETORIC AND CADENCE

### 37. Persuasive authority tropes

**Watch for:** The real question is, at its core, in reality, what really matters, fundamentally, the deeper issue, the heart of the matter
**Problem:** Pretending to cut through noise, then restating an ordinary point with ceremony.
**Before:** "At its core, what really matters is organizational readiness."
**After:** "That mostly depends on whether the organization is ready to change its habits."

### 38. Manufactured punchlines and staccato drama

**Problem:** Every sentence lands like a quotable closer, then short fragments stack up for drama. One short sentence for emphasis is fine; a run of them sounds engineered. Same for paragraphs that all end punchy: vary the endings.
**Before:** "It had no preference for symmetry. No aesthetic prior. No nostalgia. The old rules were gone."
**After:** "It did not favor symmetry or human-looking designs, which made some older assumptions less useful."

### 39. Aphorism formulas and pull-quotes

**Watch for:** X is the Y of Z, X becomes a trap, X is not a tool but a mirror, the currency of, the architecture of
**Problem:** Ordinary claims dressed as reusable aphorisms. If it sounds like a pull-quote, rewrite it as the concrete claim it gestures at.
**Before:** "Symmetry is the language of trust."
**After:** "Symmetric layouts often feel more predictable to users."

### 40. Conversational rhetorical openers

**Watch for:** Honestly?, Look,, Here's the thing, Let's be honest, Real talk, and question-then-reveal setups
**Problem:** A fake-candid hook manufactures intimacy before a routine claim. A person being honest just says the thing.
**Before:** "Is it worth the price? Honestly? It depends on how often you'll use it."
**After:** "Whether it's worth the price depends on how often you'll use it."

### 41. Narrator-from-a-distance and Wh-opener crutch

**Watch for:** Nobody designed this, This happens because, People tend to; paragraphs opening with What/When/Why/How ("What makes this hard is...") or "So,"
**Problem:** Floating above the scene in lecturer voice, or leaning on Wh-cleft openers. Put the reader in the room and lead with the subject.
**Before:** "What makes this hard is the coordination cost. People tend to underestimate it."
**After:** "The coordination cost is the hard part. You notice it the first time two teams ship the same fix."

## STATISTICAL TELLS

Beyond individual patterns, check the shape of the text. These are the signals detector research keeps finding:

| Signal | Human | AI | Why |
|--------|-------|----|-----|
| Burstiness (sentence-length variation) | High | Low | Humans write in bursts: short, then long. AI is metronomic. |
| Type-token ratio (vocabulary diversity) | 0.5-0.7 | 0.3-0.5 | AI cycles the same words. |
| Trigram repetition | Low | High | AI reuses the same 3-word phrases. |
| Paragraph uniformity | Varied | Even | AI paragraphs are all roughly the same size. |

When rewriting, fix these directly: vary sentence lengths, vary paragraph sizes, repeat the clearest word instead of cycling synonyms. The bundled `sloplint` CLI measures all four (see Verification below).

## DETECTION GUIDANCE

### What NOT to flag (false positives)

A clean human writer can hit several of the patterns above without any AI involvement. Before rewriting, sanity-check that you are not gutting legitimate prose. These are *not* reliable indicators on their own:

- **Perfect grammar and consistent style.** Polish does not equal AI.
- **Mixed casual and formal registers.** Often a person in a technical field, a young writer, or neurodivergent prose habits, not a chatbot.
- **"Bland" prose.** AI prose has *specific* tells. Generic dryness without them is just dry writing.
- **Formal vocabulary.** AI overuses *specific* fancy words (§7), not all fancy words. Don't flatten "ostensibly" just because it sounds brainy.
- **Common transition words in isolation.** One *however* is not a tell; a pile of *additionally* is.
- **Curly quotes alone.** Most editors auto-curl by default.
- **Em dashes alone.** Many journalists use them constantly. Evidence only when paired with formulaic rhythm.
- **One short emphatic sentence.** Flag staccato only when fragments stack.
- **Unsourced claims.** Most of the web is unsourced.
- **Secondhand text.** Do not rewrite watched phrases inside quotations, titles, proper names, or examples where the phrase is being discussed rather than used.

When in doubt, look for **clusters** of tells, not isolated ones. A single em dash means nothing; em dashes plus rule-of-three plus *vibrant tapestry* plus a "Conclusion" section is a confession.

### Signs of human writing (preserve these)

When you see these, lean toward leaving the prose alone. Over-editing destroys what makes it sound human:

- **Specific, unusual, hard-to-fabricate detail.** A real address. A weird quote. LLMs round off 

… Documentation preview truncated. Open the source for the complete file.