Skip to content

Commit 2c67cc5

Browse files
leonardocouyleonardocouy
committed
feat: add humanizer skill
Adds skill to remove signs of AI-generated writing from text. Based on Wikipedia's "Signs of AI writing" guide. Credits: Original skill by @blader
1 parent 118ee78 commit 2c67cc5

3 files changed

Lines changed: 561 additions & 1 deletion

File tree

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@ Skills follow the [Agent Skills](https://agentskills.io/) format.
3535
| 🎨 Design & Frontend | [mui](skills/mui/README.md) | Material-UI v7 patterns |
3636
| 🎨 Design & Frontend | [openapi-to-typescript](skills/openapi-to-typescript/README.md) | Convert OpenAPI to TypeScript |
3737
| 🛠️ Development | [database-schema-designer](skills/database-schema-designer/README.md) | Design robust database schemas |
38+
| 🛠️ Development | [dependency-updater](skills/dependency-updater/README.md) | Smart dependency management |
3839
| 🛠️ Development | [reducing-entropy](skills/reducing-entropy/README.md) | Minimize codebase size |
3940
| 🛠️ Development | [session-handoff](skills/session-handoff/README.md) | Seamless AI session transfers |
4041
| 🎯 Planning | [game-changing-features](skills/game-changing-features/README.md) | Find 10x product opportunities |
@@ -46,8 +47,8 @@ Skills follow the [Agent Skills](https://agentskills.io/) format.
4647
| 🧪 Testing | [qa-test-planner](skills/qa-test-planner/README.md) | Comprehensive QA test planning |
4748
| 📦 Git | [commit-work](skills/commit-work/README.md) | High-quality git commits |
4849
| 🔧 Utilities | [datadog-cli](skills/datadog-cli/README.md) | Debug with Datadog logs & metrics |
49-
| 🔧 Utilities | [dependency-updater](skills/dependency-updater/README.md) | Smart dependency management |
5050
| 🔧 Utilities | [domain-name-brainstormer](skills/domain-name-brainstormer/README.md) | Generate & check domain names |
51+
| 🔧 Utilities | [humanizer](skills/humanizer/README.md) | Remove AI writing patterns |
5152
| 🔧 Utilities | [meme-factory](skills/meme-factory/README.md) | Generate memes with API |
5253
| 🔧 Utilities | [web-to-markdown](skills/web-to-markdown/README.md) | Convert webpages to Markdown |
5354

‎skills/humanizer/README.md‎

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
# Humanizer
2+
3+
A Claude Code skill that removes signs of AI-generated writing from text, making it sound more natural and human.
4+
5+
## Installation
6+
7+
### Recommended (clone directly into Claude Code skills directory)
8+
9+
```bash
10+
mkdir -p ~/.claude/skills
11+
git clone https://github.com/blader/humanizer.git ~/.claude/skills/humanizer
12+
```
13+
14+
### Manual install/update (only the skill file)
15+
16+
If you already have this repo cloned (or you downloaded `SKILL.md`), copy the skill file into Claude Code’s skills directory:
17+
18+
```bash
19+
mkdir -p ~/.claude/skills/humanizer
20+
cp SKILL.md ~/.claude/skills/humanizer/
21+
```
22+
23+
## Usage
24+
25+
In Claude Code, invoke the skill:
26+
27+
```
28+
/humanizer
29+
30+
[paste your text here]
31+
```
32+
33+
Or ask Claude to humanize text directly:
34+
35+
```
36+
Please humanize this text: [your text]
37+
```
38+
39+
## Overview
40+
41+
Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) guide, maintained by WikiProject AI Cleanup. This comprehensive guide comes from observations of thousands of instances of AI-generated text.
42+
43+
### Key Insight from Wikipedia
44+
45+
> "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."
46+
47+
## 24 Patterns Detected (with Before/After Examples)
48+
49+
### Content Patterns
50+
51+
| # | Pattern | Before | After |
52+
|---|---------|--------|-------|
53+
| 1 | **Significance inflation** | "marking a pivotal moment in the evolution of..." | "was established in 1989 to collect regional statistics" |
54+
| 2 | **Notability name-dropping** | "cited in NYT, BBC, FT, and The Hindu" | "In a 2024 NYT interview, she argued..." |
55+
| 3 | **Superficial -ing analyses** | "symbolizing... reflecting... showcasing..." | Remove or expand with actual sources |
56+
| 4 | **Promotional language** | "nestled within the breathtaking region" | "is a town in the Gonder region" |
57+
| 5 | **Vague attributions** | "Experts believe it plays a crucial role" | "according to a 2019 survey by..." |
58+
| 6 | **Formulaic challenges** | "Despite challenges... continues to thrive" | Specific facts about actual challenges |
59+
60+
### Language Patterns
61+
62+
| # | Pattern | Before | After |
63+
|---|---------|--------|-------|
64+
| 7 | **AI vocabulary** | "Additionally... testament... landscape... showcasing" | "also... remain common" |
65+
| 8 | **Copula avoidance** | "serves as... features... boasts" | "is... has" |
66+
| 9 | **Negative parallelisms** | "It's not just X, it's Y" | State the point directly |
67+
| 10 | **Rule of three** | "innovation, inspiration, and insights" | Use natural number of items |
68+
| 11 | **Synonym cycling** | "protagonist... main character... central figure... hero" | "protagonist" (repeat when clearest) |
69+
| 12 | **False ranges** | "from the Big Bang to dark matter" | List topics directly |
70+
71+
### Style Patterns
72+
73+
| # | Pattern | Before | After |
74+
|---|---------|--------|-------|
75+
| 13 | **Em dash overuse** | "institutions—not the people—yet this continues—" | Use commas or periods |
76+
| 14 | **Boldface overuse** | "**OKRs**, **KPIs**, **BMC**" | "OKRs, KPIs, BMC" |
77+
| 15 | **Inline-header lists** | "**Performance:** Performance improved" | Convert to prose |
78+
| 16 | **Title Case Headings** | "Strategic Negotiations And Partnerships" | "Strategic negotiations and partnerships" |
79+
| 17 | **Emojis** | "🚀 Launch Phase: 💡 Key Insight:" | Remove emojis |
80+
| 18 | **Curly quotes** | `said “the project”` | `said "the project"` |
81+
82+
### Communication Patterns
83+
84+
| # | Pattern | Before | After |
85+
|---|---------|--------|-------|
86+
| 19 | **Chatbot artifacts** | "I hope this helps! Let me know if..." | Remove entirely |
87+
| 20 | **Cutoff disclaimers** | "While details are limited in available sources..." | Find sources or remove |
88+
| 21 | **Sycophantic tone** | "Great question! You're absolutely right!" | Respond directly |
89+
90+
### Filler and Hedging
91+
92+
| # | Pattern | Before | After |
93+
|---|---------|--------|-------|
94+
| 22 | **Filler phrases** | "In order to", "Due to the fact that" | "To", "Because" |
95+
| 23 | **Excessive hedging** | "could potentially possibly" | "may" |
96+
| 24 | **Generic conclusions** | "The future looks bright" | Specific plans or facts |
97+
98+
## Full Example
99+
100+
**Before (AI-sounding):**
101+
> The new software update serves as a testament to the company's commitment to innovation. Moreover, it provides a seamless, intuitive, and powerful user experience—ensuring that users can accomplish their goals efficiently. It's not just an update, it's a revolution in how we think about productivity. Industry experts believe this will have a lasting impact on the entire sector, highlighting the company's pivotal role in the evolving technological landscape.
102+
103+
**After (Humanized):**
104+
> The software update adds batch processing, keyboard shortcuts, and offline mode. Early feedback from beta testers has been positive, with most reporting faster task completion.
105+
106+
## References
107+
108+
- [Wikipedia: Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) - Primary source
109+
- [WikiProject AI Cleanup](https://en.wikipedia.org/wiki/Wikipedia:WikiProject_AI_Cleanup) - Maintaining organization
110+
111+
## Version History
112+
113+
- **2.1.1** - Fixed pattern #18 example (curly quotes vs straight quotes)
114+
- **2.1.0** - Added before/after examples for all 24 patterns
115+
- **2.0.0** - Complete rewrite based on raw Wikipedia article content
116+
- **1.0.0** - Initial release
117+
118+
## License
119+
120+
MIT

0 commit comments

Comments
 (0)