# Copywriting Humanizer Agent Skill

> Removes AI-sounding patterns from Chinese text while keeping facts intact. Produces publish-ready copy for chats, docs, and articles. Start free in seconds.

- Canonical: https://nanoskill.ai/tr/skills/copywriting-humanizer-agent-skill
- Markdown: https://nanoskill.ai/tr/skills/copywriting-humanizer-agent-skill.md
- Author: MrGeDiao
- Published: 2026-10-29T06:30:00.000Z
- Updated: 2026-10-29T11:28:06.557Z
- Language: tr
- Source type: github
- Popularity signal: 511

## Sources

- https://github.com/MrGeDiao/shuorenhua

## Install

```shell
npx skills add https://github.com/MrGeDiao/shuorenhua
```

## About

Speak Human is a copywriting humanizer skill that cleans Chinese AI slop from text generated by models like GPT, Claude, and Codex. It targets the robotic politeness, exaggerated empathy, and unnatural phrasing that make AI-written content feel inauthentic, while rigorously preserving hard facts such as dates, commands, and version numbers. The result is publish-ready copy for chats, docs, and long-form articles.

Unlike simple pattern replacers, it uses scene detection to adapt its intensity—light for chats, medium for status updates, and aggressive for public writing—and offers bounded editing for long text to prevent shrinkage. With over 210 Chinese phrase patterns and 96 English ones, it also handles code context and technical documentation without breaking data.

Whether you’re a developer writing a README, a maintainer replying to issues, or a blogger polishing posts, shuorenhua integrates directly into Codex, Claude Code, ChatGPT, Cursor, and custom agents. Start by cloning the repo and adding the SKILL.md file to your agent, and your Chinese text will immediately sound more human.

## Key features

- **Scene-aware cleaning**: Auto-detects chat, docs, or public writing and adjusts intensity to respect context, so you never sound like a robot or a formal announcement.
- **Fact-first protection**: Locks versions, commands, names, and evidence before editing, so crucial details stay intact after cleanup.
- **Bounded long-form handling**: For long articles, flags entire empty sentences as “suggest delete” instead of shrinking your text, giving you full control over length.
- **210+ Chinese slop patterns**: Targets engineered phrases, translator speak, and exaggerated politeness that make text feel inauthentic.
- **Multi-platform ready**: Works inside Codex, Claude Code, ChatGPT, Cursor, and any custom agent with a single SKILL.md file.

## Use cases

- **Polish team chat replies**: Use in daily conversations to remove robotic politeness while keeping your voice natural, perfect for maintaining authentic relationships.
- **Humanize technical documentation**: Apply to READMEs, release notes, and issue replies to sound like a real maintainer, not a marketing brochure.
- **Clean blog posts and long articles**: For copywriting that needs to sound human, remove AI-sounding fluff without losing key arguments or turning it into bullet points.
- **Agent-ready batch processing**: Integrate into your writing pipeline or AI agent to automatically humanize outgoing text across all channels.

## Result preview

See a de-flavoring report about 11 AI-writing issues caught across 8 patterns, with protected facts locked and a publish-ready rewrite.

![the demo of copywriting humanizer agent skill](https://file.nanoskill.ai/copywriting-humanizer-agent-skill-demo-1.png)

![the demo of copywriting humanizer agent skill](https://file.nanoskill.ai/copywriting-humanizer-agent-skill-demo-2.png)

![the demo of copywriting humanizer agent skill](https://file.nanoskill.ai/copywriting-humanizer-agent-skill-demo-3.png)

![the demo of copywriting humanizer agent skill](https://file.nanoskill.ai/copywriting-humanizer-agent-skill-demo-4.png)

## Result walkthrough

### Install

Add the Talk Like a Human Skill to your AI agent.

![the step of copywriting humanizer agent skill](https://file.nanoskill.ai/copywriting-humanizer-agent-skill-step-1.png)

### Paste the Text

Give it any Chinese draft that "reads like AI" — and tell it where it's going to be published.

![the step of copywriting humanizer agent skill](https://file.nanoskill.ai/copywriting-humanizer-agent-skill-step-2.png)

### Get a Text You'd Dare to Send

Receive a complete HTML report with named issues, a natural rewrite, and fidelity checks proving facts stayed intact.

![the step of copywriting humanizer agent skill](https://file.nanoskill.ai/copywriting-humanizer-agent-skill-step-3.png)

## Skill definition

`Talk Like a Human` specifically tackles Chinese text that is 'every word correct, but instantly reads like it’s not you.' It doesn’t dress up empty phrases or fabricate new facts for you; it first safeguards version info, commands, responsibilities, and evidence, then dismantles excessive transitions, engineer tone, Xiaohongshu AI tone, translationese, and unsourced authoritative buildup. The goal is simple: after editing, you’d dare to send it out directly.

It suits these scenarios:

| Scenario | What it does |
|----------|--------------|
| Daily chats | Removes excessive transitions, salesy endings, and engineer report tone, preserving conversational feel |
| Tech status updates | Preserves facts, versions, commands, error messages, and accountability, tamping down boilerplate |
| README / release notes | Clearly states project, changes, validation, and limitations first; no launch manifesto |
| Forum posts / issue replies | Reads like a maintainer communicating seriously, not a customer service announcement or marketing copy |
| Long Chinese articles | Cleans within sentences to keep rhythm, lists whole-sentence fluff as 'suggested deletions' for your approval, preventing long texts from getting shorter and shorter |

For English AI-tone removal, there are already [stop-slop](https://github.com/hardikpandya/stop-slop) and [humanizer](https://github.com/blader/humanizer). `Talk Like a Human` fills the gap for Chinese: internet jargon, engineer tone, Xiaohongshu AI tone, translationese, register mixing, scenario-based gradation, and factual fidelity.

## What It Changes Into

### The Patronizing Style: Awards First, Empathize Later

**Before**

> You're not oversensitive; you just haven't been held steady for too long. You've hit the core of the issue. This time I understand, I really do. I must say this very seriously: your observation and expression are absolutely the caliber of a top-journal author.

**After**

> I'm listening. If you'd like, you can continue.

The problem isn't a particular word, but the entire posture chain: first make psychological judgments for the other person, then perform empathy, and finally award them a prize. See full sample at [evals/real-samples.md](evals/real-samples.md) RS-13.

### Engineer Tone Spilling into Life

**Before**

> Conclusion first: let's have Japanese. I've gone through your takeout records from the past three weeks, narrowed the differences down to two options, and the root cause is basically confirmed: you mentioned being tired of hotpot last week. Should I go ahead and place an order from X restaurant for you? I'll act as soon as you reply.

**After**

> Let's do Japanese, since you said hotpot was getting old last week. Want me to order?

The problem with this type of text is bringing a debugging tone into life conversations. The information can be kept, the engineering-report feel doesn't need to be.

### Grand Openings in Public Introductions

**Before**

> In today's rapidly evolving AI era, how to build a tool that truly empowers developers has become a key issue the industry cannot ignore.

**After**

> There are many AI tools, but few that genuinely help developers get work done faster and more reliably. What this project does is suppress the boilerplate and performative feel from model-generated text, making the results sound more human-written.

More examples in [references/examples.md](references/examples.md) and [evals/real-samples.md](evals/real-samples.md).

## Get Started in 30 Seconds

**Codex** — single use after clone:

```bash
git clone https://github.com/MrGeDiao/shuorenhua.git && cd shuorenhua
codex exec -C . "Read ./SKILL.md and rewrite the following text according to the rules therein: ……"
```

**Claude Code** — place in the skills directory for automatic triggering:

```bash
git clone https://github.com/MrGeDiao/shuorenhua.git
mkdir -p ~/.claude/skills
cp -r shuorenhua ~/.claude/skills/shuorenhua
```

After installation, saying 'Remove AI flavor from this paragraph' in the conversation will trigger it. To follow repository updates, use a symlink instead of cp, see [install/claude-code.md](install/claude-code.md).

**ChatGPT** — no installation needed: [Talk Like a Human GPT](https://chatgpt.com/g/g-69d5d86a32608191b523efd7a4048736-shuo-ren-hua) (requires Plus / Pro), with complete rules built in.

**Just want to see issues first, without editing**: add 'Use annotation mode, only mark up without rewriting' to the instructions.

For Cursor, OpenClaw, and custom agents, see [Installation](#安装).

## How It Judges and Edits

`Talk Like a Human` does not blindly replace words. Its one-sentence principle:

> **Information first, style second.**

The complete process is fixed in six steps:

1. Determine scenario: `chat / status / docs / public-writing`; if it matches README, release notes, forum posts, issue replies, then proceed to the corresponding Scene Pack.
2. Mark protected segments: lock down numbers, versions, commands, paths, error messages, and quoted original text.
3. Decide intensity based on hit strength (`minimal / standard / aggressive`), and scope based on how much can be deleted (`structural / bounded / in-place`).
4. Edit by pattern first, using the word list only as a fallback.
5. Fidelity readback: check facts, terminology, register, and protected segments item by item.
6. Only perform a second Residual Audit if lingering tones remain, allowing only light corrections.

### Scenarios and Intensity

The default intensities for the four scenarios:

| Macro Scenario | Default Intensity | Processing Strategy |
|----------------|-------------------|---------------------|
| `chat` | Light | Only cut obvious boilerplate, don't turn chat into officialese |
| `status` | Medium | Preserve actions, status, blockers, and next steps |
| `docs` | Medium | Technical expression takes priority, with more conservative re-read |
| `public-writing` | Heavy | Full rule scan, triggering Scene Packs as needed |

### Breakdown by Publication Purpose (Scene Packs)

Publishable texts are further broken down by "where to publish", not by changing tone, but by deciding the editing approach based on publication purpose.

| Sub-scenario | Goal | Issues easily fixed |
|--------------|------|---------------------|
| README | Clear on first screen: "what is this, who is it for, what problem does it solve" | Tagline stacking, value declarations, unfocused feature lists |
| release note | Clearly list changes, verification, limitations, and migration impacts | Release speeches, excessive celebration, unclear testing |
| forum post | Like a maintainer sharing real observations and trade-offs | Company announcement tone, marketing tone, empty calls to action |
| issue reply | First confirm the issue, scope of impact, and next steps | Customer-service-style comforting, overpromising, avoiding reproduction steps |

### Long Articles Don't Shrink: Three Scopes

When rewriting long articles with default settings, deleting and merging sentences can compound, potentially shrinking 1800 characters to 1000. Conversely, not deleting a single sentence leaves whole-sentence fluff intact. So for long articles, "how much to delete" is separated into three scopes, orthogonal to intensity:

| scope | Delete whole sentences? | Applicable |
|-------|-------------------------|------------|
| `structural` | Freely delete and rearrange | Short texts, cases clearly needing rewriting |
| `bounded` (default for long) | Whole-sentence fluff listed as 'suggested deletions (to be confirmed)', with you deciding how many to remove | Long `public-writing` texts |
| `in-place` | Do not delete any sentences, only tone down within sentences | When explicitly requiring 'completely unchanged structure' |

<details>
<summary>Why these three scopes: the testing process from issue #4</summary>

When rewriting long articles with the default structural action, deleting, merging, and rearranging paragraphs can easily compound, potentially shrinking an 1800-character draft to 1000 (see [#4](https://github.com/MrGeDiao/shuorenhua/issues/4)). But conversely, doing only in-place rewriting (`in-place`) means whole-sentence fluff (unsourced references, elevated closing lines) cannot be removed, leaving the de-flavoring weaker—v1.8.6 confirmed this with real model runs: both models kept unsourced references and elevated closings as whole sentences under `in-place`.

The trade-off of `bounded`: within sentences, substantive sentences are directly edited, while rhythmic repetitions are left untouched; whole sentences that are entirely fluff (nothing left after stripping lead-ins) go into the "suggested deletions (to be confirmed)" list, with the user deciding how many to cut. This way, it neither uncontrollably shrinks like `structural`, nor leaves whole-sentence fluff in the text like `in-place`.

</details>

### What Content Is Always Priority-Protected

By default, these are priority-protected:

| Type | Examples |
|------|----------|
| Numbers and versions | Dates, ranges, units, metrics, version numbers |
| Code contexts | Commands, paths, parameters, fields, configuration items |
| Factual attribution | People's names, organization names, responsible entities, timelines |
| Quotes and evidence | Original text in quotes, error messages, status codes, experiment results |

### What Direction Does the Edited Text Tend Toward

Cleaning isn't just about deleting words. It also pulls the text in these directions:

- Specific actions over abstract elevation
- Real subjects and real actions over posturing
- Allowing slight asymmetry, not polishing every sentence into the same tone
- Calibrating by scenario, not turning chats into announcements, nor documents into stand-up comedy

## Evaluation

The rule layer covers 210+ Chinese phrases, 96 English phrases, and 19 structural anti-patterns.

The current evaluation set has 73 cases:

| Type | Count | Goal |
|------|-------|------|
| SF | 41 | Texts that should be edited must hit and correct the main issues |
| SNF | 32 | Texts that should not be wrongly edited must pass with only light hints |
| Real Samples | 19 | Whole sample graded on naturalness, fidelity, and direct-publishability; long texts add `length & rhythm` |
| Scene Packs | 8 | Positive and negative samples for README / release note / forum post / issue reply |
| Long-form In-place | 4 | For long texts preserving length, checking character retention, sentence count alignment, and key transitions |
| Bounded | 3 | For long texts, whole-sentence fluff goes into deletion list, but substantive and rhythmic sentences are not mistakenly deleted |

From v1.9.0, the benchmark switched to real dual-model runs (Codex + Claude cross-scoring, see [evals/results-v1.9.0.md](evals/results-v1.9.0.md)); static walkthroughs are relegated to quick pre-release self-checks. Full test suite at [evals/benchmark.md](evals/benchmark.md), whole real samples at [evals/real-samples.md](evals/real-samples.md). `results-v1.8.6.md` is kept as the archive of the first real model run for v1.8.6.

## Installation

| Platform | Documentation |
|----------|---------------|
| Codex | [install/codex.md](install/codex.md) |
| Claude Code | [install/claude-code.md](install/claude-code.md) |
| Cursor / Windsurf | [install/cursor.md](install/cursor.md) |
| OpenClaw | [install/openclaw.md](install/openclaw.md) |
| ChatGPT / Custom GPT | [install/chatgpt.md](install/chatgpt.md) |

The core only needs `SKILL.md` (lite); for long-term projects, public texts, and scenarios requiring false-positive protection, it's recommended to include the full `references/` package (full).

For long-term use within a project, you can add a trigger rule in `AGENTS.md`:

```markdown
## Writing Style
When a task involves rewriting to "remove the AI ​​feel," "sound human," "be natural," or "avoid sounding like a template," follow the guidelines in `shuorenhua/SKILL.md`.
Apply this approach primarily to external-facing text; do not apply this skill to code, logs, configurations, or command outputs.
```

## FAQ

### Is this for fooling AI detectors?

No. The goal is to reduce template feel, performativeness, and register drift, making the text more natural and publishable, not to bypass detection.

### Can it be used for English?

Yes, but this is a Chinese-first project. English support mainly targets cleaning common English boilerplate and template feel in mixed Chinese-English writing.

### Why does it sometimes still feel AI-ish after editing?

'Removing obvious formulaic patterns' is not the same as 'having a specific author's personal expression.' The current version is better at cleaning template feel and performativeness; it does not yet aim to mimic an individual's long-term writing habits.

### Will it mess up technical documents?

Normally, it won't edit technical documents in a chatty tone. `docs`, `status`, `code-context` all have more conservative protection strategies, prioritizing fidelity of commands, paths, versions, error messages, and metrics.

## Contributing: Bad Cases Are More Useful Than Stars

Contributions of new evaluation samples, edge cases, real problem cases, before-and-after rewriting samples, and false-positive protections are welcome.

If you encounter specific text that 'after editing still sounds like AI', you can submit it using the [bad case template](.github/ISSUE_TEMPLATE/bad-case.md). Please sanitize first; do not post unauthorized full private chats, keys, internal links, or real personally identifiable information. You can also directly post to the [collection issue](https://github.com/MrGeDiao/shuorenhua/issues/5).

Before submitting new words, consider one thing:

> Is this a 'new pattern', or just a 'variant of an existing pattern'?

Detailed rules in [CONTRIBUTING.md](CONTRIBUTING.md).

## Related Projects

- [stop-slop](https://github.com/hardikpandya/stop-slop): English AI slop rules and scoring framework
- [humanizer](https://github.com/blader/humanizer): English AI pattern classification
- [avoid-ai-writing](https://github.com/conorbronsdon/avoid-ai-writing): AI writing problem classification and severity reference

## Star History

[![Star History Chart](https://file.nanoskill.ai/svg-1.svg)](https://www.star-history.com/#MrGeDiao/shuorenhua&Date)

## License

[MIT](LICENSE)

## FAQ

### What is 说人话 (Shuorenhua)?

It's a skill that removes AI-sounding patterns from Chinese text, making it sound more natural and human-written, while preserving factual accuracy.

### How does it work?

It follows a 6-step process: scene detection, fragment protection, intensity/scoping, pattern-based rewriting, fidelity check, and residual audit.

### Is it free?

Yes, it's open-source under MIT license. You can clone the repo and use it anywhere.

### Can I use it for English?

It has some English support, but it's primarily designed for Chinese. For English, check out stop-slop or humanizer.

### Will it change technical details?

No, it protects versions, commands, paths, and error messages. Technical content is kept intact by default.

### Does it guarantee my text won't be detected as AI?

No, it's not a detection bypass tool. It aims to make text more natural and publishable, not to fool detectors.