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
17 changes: 9 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ The skill also includes a final "obviously AI generated" audit pass and a second

> "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 @@ -80,22 +80,23 @@ The skill also includes a final "obviously AI generated" audit pass and a second
| 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 Down Expand Up @@ -132,7 +133,7 @@ The skill also includes a final "obviously AI generated" audit pass and a second

## Version History

- **2.2.0** - Added a final "obviously AI generated" audit + second-pass rewrite prompts
- **2.2.0** - Added Pattern #25 (Primary Single Quotes); Added a final "obviously AI generated" audit + second-pass rewrite prompts
- **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
28 changes: 21 additions & 7 deletions SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -310,9 +310,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 @@ -326,7 +338,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 @@ -340,7 +352,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 @@ -354,7 +366,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 @@ -366,7 +378,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 @@ -378,7 +390,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 Expand Up @@ -465,7 +477,7 @@ Provide:
- Removed chatbot artifacts ("Great question!", "I hope this helps!", "Let me know if...")
- Removed significance inflation ("testament", "pivotal moment", "evolving landscape", "vital role")
- Removed promotional language ("groundbreaking", "nestled", "seamless, intuitive, and powerful")
- Removed vague attributions ("Industry observers")
- Removed vague attributions ("Industry observers") and replaced with specific sources (Google study, named engineers, Uplevel study)
- Removed superficial -ing phrases ("underscoring", "highlighting", "reflecting", "contributing to")
- Removed negative parallelism ("It's not just X; it's Y")
- Removed rule-of-three patterns and synonym cycling ("catalyst/partner/foundation")
Expand All @@ -477,6 +489,8 @@ Provide:
- Removed excessive hedging ("could potentially be argued that... might have some")
- Removed filler phrases ("In order to", "At its core")
- Removed generic positive conclusion ("the future looks bright", "exciting times lie ahead")
- Replaced media name-dropping with specific claims from specific sources
- Used simple sentence structures and concrete examples
- Made the voice more personal and less "assembled" (varied rhythm, fewer placeholders)

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