diff --git a/README.md b/README.md index 4b64359..9230f66 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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 @@ -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 diff --git a/SKILL.md b/SKILL.md index 656b2f5..f04a0a2 100644 --- a/SKILL.md +++ b/SKILL.md @@ -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... @@ -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... @@ -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. @@ -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" @@ -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. @@ -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. @@ -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") @@ -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) --- 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.