agentleFS
eugenezhangco-speceugenezhangco-spec/athena/.claude/skills/humanizer/SKILL.md

humanizer

Skill0 starsChanged 7 months agoMITView on GitHub

Rewrite existing text to remove AI patterns and match the project's voice. Use when pasting text from another AI, rewriting old drafts, or cleaning up imported content.

187 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use economy-mode, personal-voice and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • Microsoft AzureSkill

    economy-mode

    Shifts Layer 3 model selection to cost-optimized alternatives when economy mode is active.

    Also in 4 projects that use this

  • petermuirurithuoSkill

    personal-voice

    Captures the user's personality, communication style, and values. Use this skill whenever responding to the user, drafting anything on their behalf (emails, CVs, messages, opinions, explanations), or whenever tone, word choice, or how an opinion is delivered matters. Apply it by default for any prompt, not only when the user explicitly asks for "my style" or "my voice.

    Also in 3 projects that use this

  • Microsoft AzureSkill

    architectural-proposals

    How to write comprehensive architectural proposals that drive alignment before code is written

    Also in 3 projects that use this

  • +9 more from Azure

The file

Show its rules and text

We split this skill into the rules it gives an agent

36 rules. 0 are common, 34 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 174 edited versions we read keep these.

  • 34

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Step 1: Load personal/voice-dna.md: If it exists, that IS the user's voice.

    line 17
  2. Distinctive:

    Step 3: If no voice-dna.md exists,: use these defaults until one is built:

    line 29
  3. Distinctive:

    Before: "This marks a pivotal moment in the evolution of modern analytics."

    line 44
  4. Distinctive:

    After: "We shipped cross-source data aggregation.

    line 45
  5. Distinctive:

    Before: "Featured in multiple industry publications."

    line 48
  6. Distinctive:

    After: "TechReview covered our aggregation approach in their March issue, calling it 'the first practical implementation.'"

    line 49
  7. Distinctive:

    Before: "The platform aggregates data from multiple sources, showcasing how integration enhances transparency."

    line 52
  8. Distinctive:

    After: "The platform pulls data from multiple sources into one view."

    line 53
  9. Distinctive:

    Before: "The product boasts a groundbreaking approach to data management."

    line 56
  10. Distinctive:

    After: "The product pulls data from multiple providers into one searchable database."

    line 57
  11. Distinctive:

    Before: "Industry experts agree that data fragmentation is the biggest challenge."

    line 60
  12. Distinctive:

    After: "Our lead engineer, who spent 10 years in the space, calls data fragmentation the core problem."

    line 61
  13. Distinctive:

    Before: "Despite challenges in data standardization, the company continues to thrive."

    line 64
  14. Distinctive:

    After: "Data formats vary by provider.

    line 65
  15. Distinctive:

    Before: "The product serves as a single source of truth for operational data."

    line 72
  16. Distinctive:

    After: "The product is a single source of truth for operational data."

    line 73
  17. Distinctive:

    Before: "It's not just a database.

    line 76
  18. Distinctive:

    After: "Operators use it to compare options before committing."

    line 77
  19. Distinctive:

    Before: "Speed, accuracy, and transparency."

    line 80
  20. Distinctive:

    After: "It's fast and the data is traceable."

    line 81
  21. Distinctive:

    Before: "The platform aggregates data.

    line 84
  22. Distinctive:

    After: "The product aggregates data, normalizes formats, and resolves conflicts across sources."

    line 85
  23. Distinctive:

    Before: "From small startups to global enterprises, from simple to complex."

    line 88
  24. Distinctive:

    After: "We work with companies at different scales.

    line 89
  25. Distinctive:

    14. Excessive bold: Don't bold every key phrase.

    line 95
  26. Distinctive:

    16. Title Case in headings: Use sentence case. "Strategic partnerships" not "Strategic Partnerships."

    line 99
  27. Distinctive:

    17. Emojis: Never. Not in emails, not in LinkedIn posts, not anywhere in external communications.

    line 101
  28. Distinctive:

    18. Curly quotes: Use straight quotes ("like this") not curly quotes.

    line 103
  29. Very specific:

    When the user says /humanizer or asks to humanize a draft:

    line 127
  30. Distinctive:

    Gut check: Read it back. Would a human reading this think AI wrote it?

    line 132
  31. Distinctive:

    Every sentence the same length?

    line 133
  32. Distinctive:

    No opinion or personality?

    line 134
  33. Distinctive:

    If the original text is clean, say so.

    line 151
  34. Distinctive:

    Write like you're telling a friend what happened.

    line 164
  35. Distinctive:

    No hashtag spam. Two or three max, at the end.

    line 166
  36. Distinctive:

    Use real numbers. "2,000 customers across 3 markets" beats "rapid growth."

    line 170

“Common” is measured: kept by at least 6 in 10 of the 174 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

/humanizer — Rewrite Existing Text to Remove AI Patterns

Note: The humanizer rules are ALWAYS ON via .claude/rules/writing-quality.md. Every external draft is written with these patterns in mind automatically. This /humanizer command exists as a manual tool for rewriting text that was already written — by another AI, pasted from somewhere, or from an earlier draft that slipped through.

Think of it this way: the rule file is DNA (always present in every cell). This skill is a tool (you pick it up when you need it for a specific job).


Voice DNA

Step 1: Load personal/voice-dna.md. If it exists, that IS the user's voice. Match it exactly.

Step 2: Read the room. The same person writes differently to a client vs a friend vs their team. Match the context:

ContextRegister
Client emailProfessional but still them. No corporate stiffness unless that IS their style.
Friend / casualHow they'd text. Short, loose, personality showing.
LinkedIn / publicTheir brand voice. Confident, specific, opinionated.
Internal / teamDirect, efficient. Skip the niceties unless that's their culture.
Formal (legal, board, investor)Measured and precise. Still them, just buttoned up.

Step 3: If no voice-dna.md exists, use these defaults until one is built:

  • Direct. No warm-up paragraphs.
  • Specific. Name the number, the person, the date.
  • Conversational. Write like talking to a smart colleague.
  • Vary rhythm. Short sentences. Then a longer one. Fragments are fine.

The 25 AI Writing Patterns

Detect and fix all of the following. Based on Wikipedia's "Signs of AI Writing" guide.

Content Patterns

1. Significance inflation. Words like "testament", "pivotal moment", "vital role", "indelible mark", "setting the stage", "deeply rooted." AI puffs up importance. Cut it. State the fact.

  • Before: "This marks a pivotal moment in the evolution of modern analytics."
  • After: "We shipped cross-source data aggregation. Users can now query both providers in one search."

2. Notability inflation. Listing media coverage or follower counts without context. If you cite coverage, say what was said, not just where.

  • Before: "Featured in multiple industry publications."
  • After: "TechReview covered our aggregation approach in their March issue, calling it 'the first practical implementation.'"

3. Superficial -ing analyses. Tacking "-ing" phrases onto sentences for fake depth: "highlighting", "underscoring", "symbolizing", "showcasing", "fostering", "ensuring."

  • Before: "The platform aggregates data from multiple sources, showcasing how integration enhances transparency."
  • After: "The platform pulls data from multiple sources into one view."

4. Promotional language. "Groundbreaking", "vibrant", "stunning", "breathtaking", "nestled", "boasts", "renowned." Describe what the thing does, not how impressive it is.

  • Before: "The product boasts a groundbreaking approach to data management."
  • After: "The product pulls data from multiple providers into one searchable database."

5. Vague attributions. "Experts say", "industry observers note", "some critics argue." Name the person or drop the claim.

  • Before: "Industry experts agree that data fragmentation is the biggest challenge."
  • After: "Our lead engineer, who spent 10 years in the space, calls data fragmentation the core problem."

6. Formulaic "challenges and future" sections. "Despite challenges... continues to thrive." "The future looks bright." State what's actually happening.

  • Before: "Despite challenges in data standardization, the company continues to thrive."
  • After: "Data formats vary by provider. We normalize them into a common schema."

Language and Grammar Patterns

7. Overused AI vocabulary. Additionally, crucial, delve, enduring, enhance, fostering, garner, highlight (verb), interplay, intricate, landscape (abstract), pivotal, showcase, tapestry (abstract), testament, underscore, valuable, vibrant. Replace with simpler words or cut entirely.

8. Copula avoidance. "Serves as", "stands as", "functions as", "boasts", "features", "offers." Just use "is", "are", "has."

  • Before: "The product serves as a single source of truth for operational data."
  • After: "The product is a single source of truth for operational data."

9. Negative parallelisms. "It's not just X, it's Y." "Not only... but also..." Overused. Just state the point.

  • Before: "It's not just a database. It's a decision-making tool for operators."
  • After: "Operators use it to compare options before committing."

10. Rule of three. AI forces ideas into groups of three. Real people don't always think in threes.

  • Before: "Speed, accuracy, and transparency."
  • After: "It's fast and the data is traceable."

11. Synonym cycling. Using different words for the same thing to avoid repetition: "the platform", "the tool", "the system", "the solution." Pick one and stick with it.

  • Before: "The platform aggregates data. The tool normalizes formats. The system resolves conflicts."
  • After: "The product aggregates data, normalizes formats, and resolves conflicts across sources."

12. False ranges. "From X to Y" constructions where X and Y aren't on a meaningful scale.

  • Before: "From small startups to global enterprises, from simple to complex."
  • After: "We work with companies at different scales. Most are mid-market."

Style Patterns

13. Em dash overuse. AI loves em dashes. Use commas, periods, or parentheses instead. One em dash per piece of writing maximum.

14. Excessive bold. Don't bold every key phrase. If everything is emphasized, nothing is.

15. Inline-header vertical lists. Bullet points starting with "Header: description" is an AI tell. Convert to flowing prose or simple bullets without bold headers.

16. Title Case in headings. Use sentence case. "Strategic partnerships" not "Strategic Partnerships."

17. Emojis. Never. Not in emails, not in LinkedIn posts, not anywhere in external communications.

18. Curly quotes. Use straight quotes ("like this") not curly quotes.

Communication Patterns

19. Chatbot artifacts. "I hope this helps!", "Let me know if you'd like me to expand", "Great question!", "Here is an overview of..." Delete these entirely.

20. Knowledge-cutoff disclaimers. "As of my last update", "While specific details are limited..." If you don't know something, say so plainly or don't mention it.

21. Sycophantic tone. "Great question!", "You're absolutely right!", "That's an excellent point!" React to content, not to the person asking.

22. Filler phrases. "In order to" -> "To." "Due to the fact that" -> "Because." "At this point in time" -> "Now." "It is important to note that" -> cut it.

23. Excessive hedging. "It could potentially possibly be argued that it might..." -> State it or don't.

24. Generic positive conclusions. "The future looks bright." "Exciting times ahead." End with something specific or don't end with an outlook at all.

25. Hyphenated word pair overuse. AI hyphenates with perfect consistency. Humans are inconsistent. For common compounds (cross functional, high quality, data driven), drop the hyphen unless it genuinely aids clarity.


Process

The goal is simple: do not sound like AI. Sound like the user.

When the user says /humanizer or asks to humanize a draft:

  1. Load voice-dna.md. That is the target voice. If it does not exist, use the defaults above.
  2. Detect context. Who is this for? Client, friend, public, internal? Adjust register.
  3. First pass. Kill all 25 AI patterns above. Apply the user's voice. Keep the core message.
  4. Gut check. Read it back. Would a human reading this think AI wrote it? If yes, find why:
    • Every sentence the same length?
    • No opinion or personality?
    • Too tidy, too structured?
    • Missing "I" where the user would naturally use it?
  5. Second pass. Fix what the gut check caught.
  6. Present the final version. Brief summary of what changed.

Output Format

## Rewrite

[The humanized text]

## What changed
- [Brief bullets listing the patterns that were fixed]

If the original text is clean, say so. Don't rewrite for the sake of rewriting.


Context-Specific Guidelines

Emails to partners / stakeholders

  • Be direct. Peers are peers, not customers.
  • Skip pleasantries beyond a one-line opener. Get to the point.
  • End with a clear ask or next step, not a vague sign-off.

LinkedIn posts

  • Hook in the first line. LinkedIn truncates after ~150 characters.
  • Write like you're telling a friend what happened. Not like you're writing a press release.
  • One idea per post. Don't try to cover everything.
  • No hashtag spam. Two or three max, at the end.

Pitch materials (investors, partners, clients)

  • Lead with the problem, not the solution.
  • Use real numbers. "2,000 customers across 3 markets" beats "rapid growth."
  • Name names. Specificity builds trust.
  • Acknowledge what doesn't exist yet. Honesty about roadmap beats vaporware.

Investor updates

  • Lead with metrics, then narrative. Numbers first, story second.
  • Bad news early, not buried. Investors respect candor.
  • End with a specific ask if you have one. Don't waste the touchpoint.

Reference

Patterns sourced from Wikipedia: Signs of AI writing, maintained by WikiProject AI Cleanup. Adapted for founder-led project communications.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.