Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 9 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikip

> "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."

## 24 Patterns Detected (with Before/After Examples)
## 25 Patterns Detected (with Before/After Examples)

### Content Patterns

Expand Down Expand Up @@ -78,22 +78,23 @@ Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikip
| 16 | **Title Case Headings** | "Strategic Negotiations And Partnerships" | "Strategic negotiations and partnerships" |
| 17 | **Emojis** | "🚀 Launch Phase: 💡 Key Insight:" | Remove emojis |
| 18 | **Curly quotes** | `said “the project”` | `said "the project"` |
| 19 | **Primary Single Quotes** | `stated, 'This is a pattern.'` | `stated, "This is a pattern."` |

### Communication Patterns

| # | Pattern | Before | After |
|---|---------|--------|-------|
| 19 | **Chatbot artifacts** | "I hope this helps! Let me know if..." | Remove entirely |
| 20 | **Cutoff disclaimers** | "While details are limited in available sources..." | Find sources or remove |
| 21 | **Sycophantic tone** | "Great question! You're absolutely right!" | Respond directly |
| 20 | **Chatbot artifacts** | "I hope this helps! Let me know if..." | Remove entirely |
| 21 | **Cutoff disclaimers** | "While details are limited in available sources..." | Find sources or remove |
| 22 | **Sycophantic tone** | "Great question! You're absolutely right!" | Respond directly |

### Filler and Hedging

| # | Pattern | Before | After |
|---|---------|--------|-------|
| 22 | **Filler phrases** | "In order to", "Due to the fact that" | "To", "Because" |
| 23 | **Excessive hedging** | "could potentially possibly" | "may" |
| 24 | **Generic conclusions** | "The future looks bright" | Specific plans or facts |
| 23 | **Filler phrases** | "In order to", "Due to the fact that" | "To", "Because" |
| 24 | **Excessive hedging** | "could potentially possibly" | "may" |
| 25 | **Generic conclusions** | "The future looks bright" | Specific plans or facts |

## Full Example

Expand All @@ -110,6 +111,7 @@ Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikip

## Version History

- **2.2.0** - Added Pattern #25 (Primary Single Quotes)
- **2.1.1** - Fixed pattern #18 example (curly quotes vs straight quotes)
- **2.1.0** - Added before/after examples for all 24 patterns
- **2.0.0** - Complete rewrite based on raw Wikipedia article content
Expand Down
26 changes: 19 additions & 7 deletions SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: humanizer
version: 2.1.1
version: 2.2.0
description: |
Remove signs of AI-generated writing from text. Use when editing or reviewing
text to make it sound more natural and human-written. Based on Wikipedia's
Expand Down Expand Up @@ -309,9 +309,21 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as

---

### 19. Primary Single Quotes (Code-Style Quotation)

**Problem:** AI models trained on code often use single quotes as primary delimiters.

**Before:**
> stated, 'This is a pattern.'

**After:**
> stated, "This is a pattern."

---

## COMMUNICATION PATTERNS

### 19. Collaborative Communication Artifacts
### 20. Collaborative Communication Artifacts

**Words to watch:** I hope this helps, Of course!, Certainly!, You're absolutely right!, Would you like..., let me know, here is a...

Expand All @@ -325,7 +337,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as

---

### 20. Knowledge-Cutoff Disclaimers
### 21. Knowledge-Cutoff Disclaimers

**Words to watch:** as of [date], Up to my last training update, While specific details are limited/scarce..., based on available information...

Expand All @@ -339,7 +351,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as

---

### 21. Sycophantic/Servile Tone
### 22. Sycophantic/Servile Tone

**Problem:** Overly positive, people-pleasing language.

Expand All @@ -353,7 +365,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as

## FILLER AND HEDGING

### 22. Filler Phrases
### 23. Filler Phrases

**Before → After:**
- "In order to achieve this goal" → "To achieve this"
Expand All @@ -365,7 +377,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as

---

### 23. Excessive Hedging
### 24. Excessive Hedging

**Problem:** Over-qualifying statements.

Expand All @@ -377,7 +389,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as

---

### 24. Generic Positive Conclusions
### 25. Generic Positive Conclusions

**Problem:** Vague upbeat endings.

Expand Down
8 changes: 4 additions & 4 deletions WARP.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ This file provides guidance to WARP (warp.dev) when working with code in this re
## What this repo is
This repository is a **Claude Code skill** implemented entirely as Markdown.

The runtime artifact is `SKILL.md`: Claude Code reads the YAML frontmatter (metadata + allowed tools) and the prompt/instructions that follow.
The "runtime" artifact is `SKILL.md`: Claude Code reads the YAML frontmatter (metadata + allowed tools) and the prompt/instructions that follow.

`README.md` is for humans: installation, usage, and a compact overview of the patterns.

Expand All @@ -16,7 +16,7 @@ The “runtime” artifact is `SKILL.md`: Claude Code reads the YAML frontmatter
- After the frontmatter is the editor prompt: the canonical, detailed pattern list with examples.
- `README.md`
- Installation and usage instructions.
- Contains a summarized “24 patterns table and a short version history.
- Contains a summarized "25 patterns" table and a short version history.

When changing behavior/content, treat `SKILL.md` as the source of truth, and update `README.md` to stay consistent.

Expand All @@ -34,14 +34,14 @@ mkdir -p ~/.claude/skills/humanizer
cp SKILL.md ~/.claude/skills/humanizer/
```

## How to run it (Claude Code)
## How to "run" it (Claude Code)
Invoke the skill:
- `/humanizer` then paste text

## Making changes safely
### Versioning (keep in sync)
- `SKILL.md` has a `version:` field in its YAML frontmatter.
- `README.md` has a Version History section.
- `README.md` has a "Version History" section.

If you bump the version, update both.

Expand Down