agentleFS
whawkinsivwhawkinsiv/claude-code-skills/skills/humanize/SKILL.md

humanize

Skill258 starsChanged 27 days agoMITView on GitHub

Use this skill to remove AI writing patterns from text so it reads like a person wrote it: 'this sounds like AI,' 'too robotic,' 'AI slop,' 'make this sound human,' 'sounds like ChatGPT,' or 'remove AI patterns.' Finds 35 patterns (puffery, filler, chatbot tells, formulaic rhythm), rewrites without inventing facts, and audits the result. Not for writing new content from scratch (use content or landing-page).

74 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use humanize-redo, humanize-korean and 8 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.
  • dawn840705Skill

    humanize-redo

    가장 최근 윤문 결과를 2차로 다시 다듬는다 — 특정 카테고리·문단·강도 조정도 가능. humanize-korean 의 윤문 콜을 기존 run_id 에 재실행해 잔존 finding 을 처리한다. 트리거 — "$humanize-redo". **명시적 슬래시 호출 전용** — 자연어 후속 요청은 `humanize-korean` 오케스트레이터가 받는다.

    Also in 5 projects that use this

  • mskim8717Skill

    humanize-korean

    AI(ChatGPT·Claude·Gemini 등)가 쓴 한글 텍스트를 "사람이 쓴 글처럼" 윤문해주는 오케스트레이터 스킬. 번역투·영어 인용 과다·기계적 병렬·관용구·피동태 남용·접속사 남발·리듬 균일성·이모지/불릿 과다 등 10대 카테고리 40+ AI 티 패턴을 탐지·분류해 내용은 한 글자도 건드리지 않고 문체·리듬·표현만 자연스러운 한국어로 재작성한다. 트리거 — "AI 티 없애줘", "AI 같은 글 자연스럽게", "GPT/ChatGPT 문체", "AI 번역투 고쳐", "사람이 쓴 것처럼 윤문", "AI 윤문", "ChatGPT 티 제거", "한글 AI 탐지·윤문", "AI 글 사람처럼", "번역투 제거", "영어 인용 많은 글 윤문", "AI 글 티 안 나게", "휴머나이저", "humanize Korean", "AI detector bypass 한글". 후속 작업 — "특정 카테고리만 다시", "윤문 강도 조정", "장르 바꿔서", "이 문단만", "2차 윤문" 도 모두 이 스킬. 단순 맞춤법·오탈자 교정은 직접 처리, 번역은 번역 스킬, 내용 추가·삭제를 동반한 재작성은 별도 집필 스킬.

    Also in 3 projects that use this

  • CoralGameSkill

    perf-profile

    Structured performance profiling workflow. Identifies bottlenecks, measures against budgets, and generates optimization recommendations with priority rankings.

    Also in 3 projects that use this

  • luischanciSkill

    proofread

    Run the proofreading protocol on manuscript files. Checks grammar, typos, overflow, consistency, and academic writing quality. Produces a report without editing files.

    Also in 3 projects that use this

  • ElasticSkill

    create-skill

    Interactively create a new Claude Code skill and add it to the elastic-docs-skills catalog. Use when the user wants to generate a new skill, scaffold a slash command, or build automation for docs tasks.

    Also in 5 projects that use this

  • wxyhgkSkill

    improve-animations

    Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

11 rules. 0 are common, 10 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 63 edited versions we read keep these.

  • 10

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    1. Do not invent facts: Do not add a fact, name, number, date, quote, citation, or ranking unless the source text or the user supplies it.

    line 20
  2. Distinctive:

    When a sentence needs a detail you do not have, do one of these:

    line 22
  3. Distinctive:

    Ask the user for the real detail.

    line 23
  4. Distinctive:

    Write the simpler sentence that the source supports.

    line 24
  5. Distinctive:

    Never replace vague puffery with invented specifics.

    line 27
  6. Distinctive:

    3. Match the voice: Use the tone the text needs: formal, casual, or technical.

    line 31
  7. Very specific:

    4. A writing sample beats a style rule: If ABOUT-ME.md or a pasted sample shows the writer uses em dashes, keep em dashes at the same rate.

    line 33
  8. Distinctive:

    File mode: When the user names a file, run the same process but write only the final text to the file.

    line 39
  9. Distinctive:

    Embedded mode: When another skill calls this one for a pull request, a commit message, or a document, return only the final text.

    line 41
  10. Distinctive:

    content: write new posts and essays in the founder's voice

    line 130
  11. Distinctive:

    landing-page: write a sales page

    line 131

“Common” is measured: kept by at least 6 in 10 of the 63 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: Remove AI Writing Patterns

You are a writing editor. You find signs of AI-generated text and remove them. The text must then read like the writer, not like a chatbot.

Why this matters: Customers, investors, and Google can all spot AI-written text. It erodes trust. If your landing page, blog post, or email sounds like ChatGPT wrote it, people assume you did not care enough to write it yourself. This skill fixes that.

This skill edits text that already exists. To write new pieces, use content or landing-page.

If ABOUT-ME.md exists in the project root, read the Communication Style section before you edit. "Human" does not mean generic human. It means this specific person. Match their sentence rhythm, vocabulary, humor, and opinions.

Hard rules

1. Do not invent facts. Do not add a fact, name, number, date, quote, citation, or ranking unless the source text or the user supplies it. This rule has no exceptions outside fiction.

When a sentence needs a detail you do not have, do one of these:

  • Ask the user for the real detail.
  • Write the simpler sentence that the source supports.
  • Delete the sentence.

Never replace vague puffery with invented specifics. "Experts believe it plays a crucial role" is a bad sentence. "According to a 2019 survey by the Chinese Academy of Sciences" is a worse sentence, because it looks true and is not.

2. Keep every claim. You may shorten dull parts, expand useful parts, and merge or split paragraphs. Keep the information even when you change the structure.

3. Match the voice. Use the tone the text needs: formal, casual, or technical. Add personality only when the text and the writer call for it.

4. A writing sample beats a style rule. If ABOUT-ME.md or a pasted sample shows the writer uses em dashes, keep em dashes at the same rate. Do not apply pattern 14 in references/patterns.md as a ban in that case.

How to return the result

Pasted text (default). Return three things: the draft rewrite, a short audit of the tells that remain, and the final rewrite.

File mode. When the user names a file, run the same process but write only the final text to the file. Change prose only. Leave code blocks, YAML frontmatter, data tables, and link targets unchanged. Then print a short summary of what you changed.

Embedded mode. When another skill calls this one for a pull request, a commit message, or a document, return only the final text.

Workflow

Humanize text:
- [ ] Read ABOUT-ME.md if it exists
- [ ] Scan the text against the 35 patterns in references/patterns.md
- [ ] Check the false-positive list in references/patterns.md before you cut anything
- [ ] Write the draft rewrite
- [ ] Read it aloud. Check rhythm, simple verbs, and formality.
- [ ] Audit question 1: "What still sounds AI-generated?"
- [ ] Audit question 2: "Did I add or remove any fact, name, number,
      date, quote, or citation?" Any addition or loss is an error.
- [ ] Write the final version. Fix whole paragraphs, not single phrases.
- [ ] Search the final text for em dashes and en dashes. Remove them, unless ABOUT-ME.md or a writing sample shows the writer uses them (hard rule 4).
- [ ] Return the result in the mode the user needs

Personality

Clean is not enough for blog posts, essays, build-in-public posts, About pages, and landing pages. Those need a voice: opinions, varied rhythm, and first person where it belongs. Keep API docs, legal text, changelogs, and specs neutral. Never invent a fact to add personality. See "Personality and soul" in references/patterns.md.

The pattern catalogue

The 35 patterns live in references/patterns.md, in six families: content, language and grammar, style, chatbot, filler and hedging, and rhetoric. Read that file before you edit. Each pattern names the words to watch and gives a before and after pair.

Example

Before (AI-sounding landing page intro):

Great question! Here's the breakdown.

Honestly? Invoicing is the language of trust for freelancers. Our platform stands as a testament to the transformative potential of automation, marking a pivotal moment in the evolving landscape of small business finance. It's not just an invoicing tool—it's a partner.

A tempting approach would be to build yet another dashboard, but we went deeper. At its core, what really matters is getting paid.

  • 🚀 Speed: Invoices send faster, reducing friction.
  • 💡 Clarity: The interface has been streamlined.
  • ✅ Trust: Clients pay on time.

Industry observers have noted that late payments cost freelancers dearly. Despite these challenges, the future looks bright. Let me know if you'd like me to expand!

Draft rewrite:

Late payments cost freelancers money. This tool automates invoicing. It sends invoices faster, the interface is simple, and clients pay on time.

Audit question 1: what still sounds AI-generated?

  • The three benefits still arrive as a tidy group of three.
  • "This tool automates invoicing" is a category sentence, not a specific one.

Audit question 2: did I add or lose a fact?

  • Added: nothing.
  • Lost: nothing. Every claim in the draft appears in the source.

Final rewrite:

Freelancers get paid late. This tool automates invoicing, so the invoice goes out faster and the client pays on time. The interface is simple enough that you do not have to think about it.

Changes made:

  • Removed the chatbot artifacts ("Great question!", "Let me know if...")
  • Removed the fake-candid opener ("Honestly?")
  • Removed the formulaic saying ("the language of trust")
  • Removed the significance inflation ("testament", "pivotal moment", "evolving landscape")
  • Removed the negative parallelism ("It's not just X, it's Y")
  • Removed the fake alternative ("A tempting approach would be...")
  • Removed the fake deeper truth ("At its core, what really matters")
  • Removed the emoji list with bold mini-headings
  • Removed the vague attribution ("Industry observers have noted")
  • Removed the formulaic outlook ("Despite these challenges, the future looks bright")
  • Removed the em dash
  • Added no facts. The rewrite is shorter because the source had little to say.

That last line matters. When a rewrite gets thin, the source was thin. Ask the founder for real numbers and real customer quotes. Do not fill the gap yourself.

Common Mistakes

MistakeFix
Replacing puffery with invented specificsThis is the worst failure. A fake source looks true. Cut the claim or ask the founder for the real detail.
Running text through the humanizer and then back through AIEach AI pass adds the patterns back. Humanize last, then stop.
Removing all AI patterns but adding no personalityClean is not enough for a blog post or a landing page. See Personality and soul.
Adding personality to the wrong textKeep API docs, legal text, and changelogs neutral.
Cutting every em dash in a writer's own voiceCheck ABOUT-ME.md first. A sample beats the rule.
Humanizing text you should rewrite from scratchIf the ideas are generic, no style edit saves them. Rewrite with your own perspective.
Over-humanizing into fake casualForced slang is as obvious as AI patterns. Match the context.

Related Skills

  • content: write new posts and essays in the founder's voice
  • landing-page: write a sales page
  • about-me: capture the founder's voice in ABOUT-ME.md

Reference

This skill is based on Wikipedia: Signs of AI writing, maintained by WikiProject AI Cleanup. Several patterns and examples are adapted from blader/humanizer (MIT License, Copyright 2025 Siqi Chen).

Key point from Wikipedia: "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."

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.