diff --git a/README.md b/README.md index c895465..48d63b3 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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 @@ -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 diff --git a/SKILL.md b/SKILL.md index bbf7e38..a2403af 100644 --- a/SKILL.md +++ b/SKILL.md @@ -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 @@ -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... @@ -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... @@ -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. @@ -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" @@ -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. @@ -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. diff --git a/WARP.md b/WARP.md index f722d1f..e13d768 100644 --- a/WARP.md +++ b/WARP.md @@ -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. @@ -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. @@ -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.