# Humanizer-zh: AI Writing De-Stamp Tool

> **Notes**
> - The core files were translated from [blader/humanizer](https://github.com/blader/humanizer/tree/main)
> - The practical rule set, quick checklist, and quality score were inspired by [hardikpandya/stop-slop](https://github.com/hardikpandya/stop-slop)
> - The original project is based on Wikipedia’s [Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing)

---

## What this project is

Humanizer-zh helps remove the traces of AI generation from text so it reads more naturally and more like human writing.

It is useful for:

- Editing and reviewing AI-generated content
- Improving the human feel of articles
- Learning to recognize common AI writing patterns

## Install

### Method 1: one-line install with npx

```bash
npx skills add https://github.com/op7418/Humanizer-zh.git
```

### Method 2: clone with git

```bash
git clone https://github.com/op7418/Humanizer-zh.git ~/.claude/skills/humanizer-zh
```

### Method 3: manual install

1. Download the ZIP or clone the repo locally.
2. Copy the `Humanizer-zh` folder into your Claude Code skills directory.
3. Confirm the folder structure matches the expected `SKILL.md` and `README.md` layout.

### Verify the install

Restart Claude Code or reload skills, then type:

```text
/humanizer-zh
```

If the install worked, the skill should activate.

## Usage

### Basic usage

Use it in Claude Code like this:

```text
/humanizer-zh Please humanize the following text:
```

### Example scenarios

#### Rewrite marketing copy

The tool can turn inflated marketing language into something grounded and believable.

#### Rewrite an academic abstract

The tool can turn a generic academic abstract into a more concrete summary with real details.

#### Rewrite a blog post

The tool can turn a polished but lifeless AI paragraph into something that sounds like a real person talking.

## AI writing patterns it can detect

It recognizes and repairs 24 common AI writing traces across four categories:

### Content patterns

1. Overstating meaning, legacy, and broader trends
2. Overstating fame and media coverage
3. Shallow -ing endings
4. Promotional and ad-like language
5. Vague attribution and fuzzy wording
6. Outline-style “challenges and future outlook” sections

### Language and grammar patterns

7. Overused AI vocabulary
8. Avoiding the verb “to be”
9. Negative parallelism
10. Overuse of the rule of three
11. Forced synonym cycling
12. False scope

### Style patterns

13. Overuse of em dashes
14. Overuse of bold text
15. Inline heading vertical lists
16. Title case in headings
17. Emojis
18. Curly quotes

### Conversation patterns and filler

19. Collaboration traces
20. Knowledge-cutoff disclaimers
21. Sycophantic tone
22. Filler phrases
23. Over-qualification
24. Generic positive conclusions

## File guide

- `SKILL.md` - Chinese skill definition
- `README.md` - this documentation

**Note:** for the original English project, see [blader/humanizer](https://github.com/blader/humanizer)

## Manual workflow

1. Detect the AI pattern.
2. Rewrite the problematic segment.
3. Preserve the core meaning.
4. Match the appropriate tone.
5. Inject a real human voice.

## Principles

The main idea is not just to make text “clean,” but to make it feel alive:

- Have a point of view
- Vary the rhythm
- Admit complexity
- Use “I” when it is honest
- Allow some messiness
- Be specific about feelings

## Common AI vocabulary to watch for

Words that appear unusually often in AI-generated text include:

- moreover
- crucial
- delve
- emphasize
- lasting
- enhance
- cultivate
- obtain
- highlight
- interaction
- complex / complexity
- landscape
- showcase
- tapestry
- evidence
- valuable
- vibrant

## Contributing

If you find translation issues or want to improve the docs, feel free to open an issue or pull request.

## Reference

- [Wikipedia: Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing)
- [WikiProject AI Cleanup](https://en.wikipedia.org/wiki/Wikipedia:WikiProject_AI_Cleanup)
- [blader/humanizer](https://github.com/blader/humanizer)
- [hardikpandya/stop-slop](https://github.com/hardikpandya/stop-slop)

## License

This translation follows the upstream project’s license.

---

**Reminder:** this tool is not for “cheating” AI detectors. It is for actually improving writing quality.
