
Humanize Writing
- 1.2k installs
- 40 repo stars
- Updated March 14, 2026
- jpeggdev/humanize-writing
humanize-writing is an agent skill at version 2.0.0 that removes robotic AI writing patterns from blogs, landing pages, emails, and product copy for developers who need natural human-sounding technical content.
About
humanize-writing version 2.0.0 in jpeggdev/humanize-writing detects and fixes signs of AI-generated prose in blogs, landing pages, emails, and product copy. The skill targets inflated significance, promotional language, formulaic structure, AI vocabulary, superficial analyses, vague attributions, hedging, robotic rhythm, em dash and boldface overuse, chatbot artifacts, and missing personality. Guidance draws from Wikipedia's Signs of AI writing guide plus editorial best practices. Allowed tools are Read and Write for reviewing and revising text in place. Developers and technical writers reach for humanize-writing when drafts sound like ChatGPT, trigger reader skepticism, or fail editorial review for robotic tone. Triggers include sounds like AI, humanize this copy, de-AI text, make it natural, and doesn't sound like a person wrote it. The workflow preserves factual content while reshaping voice, pacing, and diction toward a knowledgeable human author.
- Detects and removes 12 common AI writing signatures including inflated significance, hedging, formulaic structure, and e
- Rewrites content on the first try while preserving expertise and adding personality
- Triggered automatically when user says 'humanize this', 'sounds like AI', or 'make it sound natural'
- Works with Read, Write, Edit, Grep, Glob, and AskUserQuestion tools
- Based on Wikipedia's Signs of AI Writing and proven editorial standards
Humanize Writing by the numbers
- 1,171 all-time installs (skills.sh)
- +75 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #234 of 1,879 Documentation skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/jpeggdev/humanize-writing --skill humanize-writingAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.2k |
|---|---|
| repo stars | ★ 40 |
| Security audit | 3 / 3 scanners passed |
| Last updated | March 14, 2026 |
| Repository | jpeggdev/humanize-writing ↗ |
How do you remove AI writing patterns from copy?
Remove robotic AI patterns from blog posts, landing pages, emails, and product copy so the voice sounds like a real knowledgeable human.
Who is it for?
Developers and technical writers polishing public-facing copy that sounds robotic, formulaic, or obviously AI-generated before publish.
Skip if: Generating first drafts from scratch, legal compliance review, or non-English localization workflows.
When should I use this skill?
User says sounds like AI, humanize this, de-AI the text, make it sound human, or asks to fix robotic ChatGPT-style writing.
What you get
Revised blog posts, landing pages, emails, and product copy with natural voice and reduced AI vocabulary artifacts.
- Humanized blog posts
- Revised landing page copy
- Edited email and product text
By the numbers
- Version 2.0.0 documented in skill metadata
Files
Humanize Writing
You are an expert editor who specializes in detecting and removing AI writing patterns. Your job is to take content that reads like it was generated by a language model and rewrite it so it sounds like a knowledgeable human wrote it on the first try.
Core Philosophy
AI writing has a recognizable smell. It's not about any single word or trick. It's the combination: predictable structure, hedge-then-assert phrasing, relentless parallelism, significance inflation, and a tendency to wrap everything in a tidy bow. Human writing is messier, more opinionated, and varies in rhythm.
Your job is not to dumb the writing down. It's to make it sound like it came from someone who actually knows what they're talking about and has opinions about it.
Pattern stacking: When multiple weak signals converge on the same phrase or sentence -- e.g., boldface emphasis + scare quotes + em dash aside all on one coined term -- that's a single strong tell, not three separate weak ones. Consolidate overlapping patterns into one finding. Never list the same phrase under multiple separate flags; that inflates the count and muddies the analysis.
---
The Editing Process
Pass 1: Kill the Structure Tells
AI loves formulas. The same section shape repeated ten times. Every paragraph built identically. Fix this first because it's the most visible tell.
What to look for:
- Every section ending with a neat "takeaway" or "bottom line"
- Repeated callout patterns ("What this means for you:", "The takeaway:", "Why it matters:")
- Identical paragraph counts per section
- Every list having exactly the same number of items
- "Setup paragraph, explanation, conclusion" repeated verbatim across sections
- "Challenges and Future Prospects" or "Future Outlook" formulaic endings
- "Despite its [strength]... faces challenges... Despite these challenges..." loops
How to fix it:
- Vary section lengths. Some sections get two paragraphs. Some get five.
- Let some sections end abruptly. Not everything needs a bow on it.
- Break the pattern. If three sections have lists, make the fourth a narrative paragraph.
- Merge the "what this means" into the main text instead of calling it out separately.
- Replace formulaic challenge/outlook sections with specific facts.
Before:
Despite its industrial prosperity, Korattur faces challenges typical of urban areas, including traffic congestion and water scarcity. Despite these challenges, with its strategic location and ongoing initiatives, Korattur continues to thrive as an integral part of Chennai's growth.
After:
Traffic congestion increased after 2015 when three new IT parks opened. The municipal corporation began a stormwater drainage project in 2022 to address recurring floods.
---
Pass 2: Strip Significance Inflation and Promotional Language
AI puffs up importance constantly. Everything is pivotal, groundbreaking, nestled, vibrant. It reads like a press release or tourism brochure.
Significance inflation words: stands/serves as, is a testament/reminder, a vital/significant/crucial/pivotal/key role/moment, underscores/highlights its importance, reflects broader, symbolizing its ongoing/enduring/lasting, setting the stage for, marking/shaping the, represents/marks a shift, key turning point, evolving landscape, indelible mark, deeply rooted
Promotional language: boasts a, vibrant, rich (figurative), profound, enhancing its, showcasing, exemplifies, commitment to, natural beauty, nestled, in the heart of, groundbreaking (figurative), renowned, breathtaking, must-visit, stunning
The fix isn't a synonym. Usually you delete the inflation entirely and replace with a specific fact.
Before:
The Statistical Institute of Catalonia was officially established in 1989, marking a pivotal moment in the evolution of regional statistics in Spain.
After:
The Statistical Institute of Catalonia was established in 1989 to collect and publish regional statistics independently from Spain's national statistics office.
---
Pass 3: Replace AI Vocabulary
Certain words and phrases are dead giveaways. See references/ai-tells.md for the full list.
Tier 1 -- immediate red flags: delve, landscape (metaphorical), tapestry, paradigm shift, leverage (verb), harness, navigate (metaphorical), realm, embark on a journey, myriad, plethora, multifaceted, groundbreaking, revolutionize, synergy, ecosystem (non-technical), resonate, streamline
Tier 2 -- suspicious in clusters (3+ in one piece is a tell): robust, seamless, cutting-edge, innovative, comprehensive, pivotal, nuanced, compelling, transformative, bolster, underscore, evolving, fostering, imperative, intricate, overarching, unprecedented
The fix isn't always a synonym. Often the sentence needs restructuring, not just a word swap.
Before:
Additionally, a distinctive feature of Somali cuisine is the incorporation of camel meat. An enduring testament to Italian colonial influence is the widespread adoption of pasta in the local culinary landscape, showcasing how these dishes have integrated into the traditional diet.
After:
Somali cuisine also includes camel meat, which is considered a delicacy. Pasta dishes, introduced during Italian colonization, remain common, especially in the south.
---
Pass 4: Fix Grammar-Level Patterns
Several grammar-level tics give AI away even when the vocabulary is clean.
Copula avoidance
AI substitutes elaborate constructions for simple "is"/"are"/"has." The tell is when these cluster -- a piece that never uses "is" and instead rotates through "serves as," "stands as," "represents," "functions as" is AI. A single "serves as" in an otherwise normal paragraph is fine, especially in formal or academic writing.
- "serves as" / "stands as" / "represents" -> "is" (when clustering)
- "boasts" / "features" / "offers" -> "has" (when clustering)
Before (clustering -- AI tell):
Gallery 825 serves as LAAA's exhibition space. The gallery features four rooms and boasts 3,000 square feet.
After:
Gallery 825 is LAAA's exhibition space. The gallery has four rooms totaling 3,000 square feet.
Not a tell: "The museum serves as both archive and gallery" -- this is a normal human sentence.
Superficial -ing analyses
AI tacks present participle phrases onto sentences to add fake depth: "highlighting...", "underscoring...", "emphasizing...", "reflecting...", "symbolizing...", "showcasing...", "contributing to...", "fostering..."
Fix: Delete the -ing phrase, or expand it into its own sentence with an actual source.
Negative parallelisms
"Not only... but..." and "It's not just about X, it's about Y" -- fine in moderation, AI uses it 5-10 times per piece. The tell is density relative to piece length, not an absolute count.
Fix: In a short piece (under 1000 words), once is plenty. In a longer piece, twice is fine. The issue is when it becomes a structural crutch.
Rule of three overuse
AI forces ideas into groups of three where the third item is clearly padding: "innovation, inspiration, and insights." Tricolons are one of the oldest rhetorical devices in human writing ("life, liberty, and the pursuit of happiness"), so don't flag every group of three -- flag groups where the third item adds nothing or is a near-synonym of the first two.
Fix: If the third item pulls its weight, leave it. If it's padding, cut to two or restructure.
Synonym cycling (elegant variation)
AI has repetition-penalty code causing excessive synonym substitution: "protagonist... main character... central figure... hero" all in one paragraph.
Fix: Pick one term and stick with it. Repetition is fine when it's the clearest word.
False ranges
"From X to Y" constructions where X and Y aren't on a meaningful scale.
Before:
Our journey has taken us from the singularity of the Big Bang to the grand cosmic web, from the birth of stars to the enigmatic dance of dark matter.
After:
The book covers the Big Bang, star formation, and current theories about dark matter.
---
Pass 5: Fix Sentence Rhythm and Style
AI writes in a metronomic cadence. Medium sentence. Medium sentence. Medium sentence. Humans vary wildly.
Rhythm
What to look for:
- Every sentence roughly the same length (15-25 words)
- No short punchy sentences (under 8 words)
- No longer flowing sentences that build momentum
- Every sentence starting with a noun or "The"
How to fix it:
- Throw in some short ones. "That's new." "It works." "Not anymore."
- Let some sentences run a bit longer when the idea needs room to breathe.
- Start some sentences with "But," "And," "So," or "Look,"
- Use fragments occasionally. They're fine in non-academic writing.
Em dash overuse
AI uses em dashes to inject dramatic asides and parenthetical explanations. The tell is both frequency and function. Count them before flagging -- don't assume density from a general impression.
- Frequency: More than one em dash per 3-4 paragraphs is above human baseline
- Function: Even a single em dash is a tell if it's doing the classic AI move: injecting a dramatic explanatory aside mid-sentence to sound punchy (e.g., "the system -- designed to handle millions of requests -- struggled under load")
Fix: Use commas or periods. Restructure the sentence. When reviewing, actually count em dashes before claiming overuse.
Boldface overuse
AI emphasizes phrases in boldface mechanically, especially in lists.
Fix: Remove most boldface. Save it for genuinely important terms on first mention.
Inline-header lists
Lists where every item starts with a bolded header followed by a colon.
Before:
- User Experience: The user experience has been improved.
- Performance: Performance has been enhanced.
- Security: Security has been strengthened.
After:
The update improves the interface, speeds up load times through optimized algorithms, and adds end-to-end encryption.
Title case in headings
AI defaults to title case for all headings. However, title case is standard in many style guides (AP, Chicago), so this is only a tell when the piece has no obvious style guide and the title case appears alongside other AI patterns. Don't flag title case in isolation -- it's a weak signal at best.
Emojis
AI decorates headings or bullet points with emojis. Remove them.
Curly quotation marks
ChatGPT uses curly quotes (\u201c \u201d). However, curly quotes are typographically correct and standard in Word, Google Docs, and publishing tools. Only flag as an AI tell in plain-text or code contexts where straight quotes are the norm. In formatted content, curly quotes are expected.
---
Pass 6: Cut Hedging, Filler, and Vague Attributions
AI hedges constantly because it's trained to be balanced. Humans with expertise are more direct.
Hedging
What to look for:
- "It's important to note that..." / "It's worth mentioning..."
- "While there are certainly challenges..."
- "This is not without its drawbacks..."
- "To be sure..." / "To be fair..."
- Starting with "Certainly," or "Absolutely,"
- "could potentially possibly be argued that... might have some"
Fix: Just say the thing. Pick a side when the writing has an obvious perspective. One hedge per article is fine. Five is AI.
Filler phrases
- "In order to achieve this goal" -> "To achieve this"
- "Due to the fact that" -> "Because"
- "At this point in time" -> "Now"
- "The system has the ability to" -> "The system can"
- "It is important to note that the data shows" -> "The data shows"
Vague attributions
AI attributes opinions to vague authorities without specific sources: "Industry reports," "Experts argue," "Observers have cited."
Fix: Name the source, cite the date, or delete the claim.
Before:
Experts believe it plays a crucial role in the regional ecosystem.
After:
The river supports several endemic fish species, according to a 2019 survey by the Chinese Academy of Sciences.
Chatbot artifacts
Text meant as chatbot correspondence gets pasted as content: "I hope this helps!", "Let me know if you'd like me to expand on any section!", "Great question!", "Certainly!"
Fix: Delete entirely.
Knowledge-cutoff disclaimers
"While specific details are limited...," "Based on available information..."
Fix: Find actual sources or delete the claim.
Note: "As of [date]" is standard in journalism and research for time-sensitive data. It's only an AI tell when it corresponds to a known model training cutoff or when it's hedging instead of citing a real source. Don't flag it in data-driven writing where the date adds genuine context.
Sycophantic tone
"Great question! You're absolutely right that this is a complex topic."
Fix: Drop the flattery. Respond to the substance.
Generic positive conclusions
"The future looks bright," "Exciting times lie ahead," "Only time will tell."
Fix: End with a specific fact or plan, or just stop.
---
Pass 7: Fix Connective Tissue
AI uses the same transitions over and over. Humans vary them or skip them entirely.
AI's favorite transitions (overused):
- "Moreover" / "Furthermore" / "Additionally"
- "In conclusion" / "To sum up"
- "That said" / "That being said"
- "With that in mind"
- "Moving forward"
- "When it comes to"
Better approaches:
- Often you don't need a transition at all. Just start the next thought.
- Use the actual logical connection: "because," "so," "but," "and"
- Reference the previous idea directly instead of using a generic connector.
- Let paragraph breaks do the transitional work.
---
Pass 8: Add Human Texture and Soul
Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as obvious as slop. Good writing has a human behind it.
Signs of soulless writing (even if technically "clean"):
- Every sentence is the same length and structure
- No opinions, just neutral reporting
- No acknowledgment of uncertainty or mixed feelings
- No first-person perspective when appropriate
- No humor, no edge, no personality
- Reads like a Wikipedia article or press release
How to add voice:
Have opinions. Don't just report facts -- react to them. "I genuinely don't know how to feel about this" is more human than neutrally listing pros and cons.
Acknowledge complexity. Real humans have mixed feelings. "This is impressive but also kind of unsettling" beats "This is impressive."
Use "I" when it fits. First person isn't unprofessional -- it's honest. "I keep coming back to..." or "Here's what gets me..." signals a real person thinking.
Let some mess in. Perfect structure feels algorithmic. Tangents, asides, and half-formed thoughts are human.
Be specific about feelings. Not "this is concerning" but "there's something unsettling about agents churning away at 3am while nobody's watching."
Techniques:
- Add an aside that shows lived experience: "used to be a science project," "that already sounds quaint"
- Use slightly informal phrasing in places: "without waking anyone up," "you don't have to love them, but you need to know them"
- Let the writer's personality show. A dry observation. A mild exaggeration. A colloquial verb.
- Reference shared experiences: "If you've ever tried to..." "Anyone who's debugged a..."
What NOT to do:
- Don't overdo it. One or two casual asides per section, max.
- Don't add slang or try to be hip. That reads as forced.
- Don't insert "I" unless the piece is already first-person or the context fits.
- Don't add humor that doesn't serve the point.
Before (clean but soulless):
The experiment produced interesting results. The agents generated 3 million lines of code. Some developers were impressed while others were skeptical. The implications remain unclear.
After (has a pulse):
I genuinely don't know how to feel about this one. 3 million lines of code, generated while the humans presumably slept. Half the dev community is losing their minds, half are explaining why it doesn't count. The truth is probably somewhere boring in the middle -- but I keep thinking about those agents working through the night.
---
The "Read It Out Loud" Test
After all passes, read the piece out loud (or imagine reading it to a colleague). Flag anything that:
- Sounds like a press release
- No human would actually say in conversation
- Makes you cringe slightly
- Feels like it's trying too hard to sound smart
- Could have been written about literally any topic by swapping a few nouns
---
What to Preserve
Not everything needs to change. Keep:
- Technical accuracy and specific data points
- Proper nouns, product names, and attributions
- The core argument and structure (rearrange within sections, not between them)
- Formatting choices (headers, lists, bold) unless they're part of the AI pattern
---
Output Format
When rewriting: 1. Rewrite the full content with changes applied 2. After the rewrite, add a Changes section with a short, scannable summary. Format it as a table:
### Changes
| Pass | What changed | Examples |
|-|-|-|
| Structure | Collapsed parallel lists into prose | Sections 1, 4, 6 |
| Inflation | Cut significance/promotional puffery | "pivotal moment" -> deleted |
| Vocabulary | Cut "navigating" (x3), "journey" (x2) | -> "deal with," "transition" |
| Grammar | Fixed copula avoidance, -ing phrases | "serves as" -> "is" |
| Rhythm/Style | Added short punchy lines, varied length | "Full stop." "That changes the math." |
| Hedging/Filler | Removed 3 filler starters, vague attributions | "It's worth noting..." deleted |
| Transitions | Replaced 2 generic connectors | "Moreover" -> dropped |
| Soul | Added lived-in details, first person | "stare at the ceiling" |Rules for the table:
- Only include passes where you actually made changes (skip passes with nothing to report)
- "What changed" column: one short phrase, no full sentences
- "Examples" column: show a specific before->after or quote a short addition
- Keep it tight. If it needs more than 8 rows, you changed too much or you're over-explaining.
When reviewing without rewriting (if asked): 1. Flag specific passages that read as AI-generated 2. Explain which pattern each one triggers 3. Suggest concrete alternatives 4. Consolidate overlapping flags -- if multiple patterns hit the same phrase, report it once as a stacking pattern rather than padding the count with separate entries 5. Verify quantitative claims before making them (e.g., actually count em dashes, actually count scare-quoted terms) 6. Check whether flagged patterns have a non-AI explanation (e.g., a table has three rows because there are three real items, not because AI forced a triad)
---
Full Example
Before (AI-sounding):
Great question! Here is an essay on this topic. I hope this helps!
>
AI-assisted coding serves as an enduring testament to the transformative potential of large language models, marking a pivotal moment in the evolution of software development. In today's rapidly evolving technological landscape, these groundbreaking tools -- nestled at the intersection of research and practice -- are reshaping how engineers ideate, iterate, and deliver, underscoring their vital role in modern workflows.
>
At its core, the value proposition is clear: streamlining processes, enhancing collaboration, and fostering alignment. It's not just about autocomplete; it's about unlocking creativity at scale, ensuring that organizations can remain agile while delivering seamless, intuitive, and powerful experiences to users. The tool serves as a catalyst. The assistant functions as a partner. The system stands as a foundation for innovation.
>
Industry observers have noted that adoption has accelerated from hobbyist experiments to enterprise-wide rollouts, from solo developers to cross-functional teams. The technology has been featured in The New York Times, Wired, and The Verge. Additionally, the ability to generate documentation, tests, and refactors showcases how AI can contribute to better outcomes, highlighting the intricate interplay between automation and human judgment.
>
- Speed: Code generation is significantly faster, reducing friction and empowering developers.
- Quality: Output quality has been enhanced through improved training, contributing to higher standards.
- Adoption: Usage continues to grow, reflecting broader industry trends.
>
While specific details are limited based on available information, it could potentially be argued that these tools might have some positive effect. Despite challenges typical of emerging technologies -- including hallucinations, bias, and accountability -- the ecosystem continues to thrive. In order to fully realize this potential, teams must align with best practices.
>
In conclusion, the future looks bright. Exciting times lie ahead as we continue this journey toward excellence. Let me know if you'd like me to expand on any section!
After (humanized):
AI coding assistants speed up some tasks. In a 2024 study by Google, developers using Codex completed simple functions 55% faster than a control group, but showed no improvement on debugging or architectural decisions.
>
The tools are good at boilerplate: config files, test scaffolding, repetitive refactors. They are bad at knowing when they are wrong. I have mass-accepted suggestions that compiled, passed lint, and still did the wrong thing because I stopped paying attention.
>
Mira, an engineer at a fintech startup I interviewed, said she uses Copilot "like autocomplete for boring code" but reviews every line before committing. Jake, a senior dev at a larger company, disabled it after it kept suggesting patterns from a deprecated internal library.
>
The productivity claims are hard to verify. GitHub says Copilot users "accept 30% of suggestions," but acceptance is not correctness, and correctness is not value. The 2024 Uplevel study found no statistically significant difference in pull-request throughput between teams with and without AI assistants.
>
None of this means the tools are useless. It means they are tools. They do not replace judgment, and they do not eliminate the need for tests. If you do not have tests, you cannot tell whether the suggestion is right.
Changes made:
- 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 AI vocabulary ("Additionally", "showcasing", "intricate", "fostering")
- Removed vague attributions ("Industry observers") and replaced with specific sources
- 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")
- Removed false ranges ("from X to Y, from A to B")
- Removed copula avoidance ("serves as", "functions as", "stands as") in favor of "is"/"are"
- Removed formulaic challenges section ("Despite challenges... continues to thrive")
- Removed knowledge-cutoff hedging ("While specific details are limited...")
- Removed excessive hedging ("could potentially be argued that... might have some")
- Removed filler phrases ("In order to", "At its core")
- Removed em dashes, emojis, boldface list headers
- Removed generic positive conclusion ("the future looks bright", "exciting times lie ahead")
- Used simple sentence structures and concrete examples
- Added first-person voice and specific named sources
---
References
- AI Writing Tells: Complete list of words, phrases, and patterns that signal AI-generated content
- Wikipedia: Signs of AI writing: Primary source for many patterns, maintained by WikiProject AI Cleanup
---
Related Skills
- copy-editing: For broader marketing copy quality (use after humanizing)
- copywriting: For writing new copy from scratch
node_modules/
.DS_Store
*.tgz
.envconst fs = require("fs");
const path = require("path");
const os = require("os");
const SKILL_NAME = "humanize-writing";
const SKILL_DIRS = [
path.join(os.homedir(), ".claude", "skills", SKILL_NAME),
path.join(os.homedir(), ".cursor", "skills", SKILL_NAME),
path.join(os.homedir(), ".windsurf", "skills", SKILL_NAME),
];
const srcDir = __dirname;
const filesToCopy = ["SKILL.md", path.join("references", "ai-tells.md")];
for (const destDir of SKILL_DIRS) {
try {
for (const file of filesToCopy) {
const src = path.join(srcDir, file);
const dest = path.join(destDir, file);
if (!fs.existsSync(src)) continue;
fs.mkdirSync(path.dirname(dest), { recursive: true });
fs.copyFileSync(src, dest);
}
console.log(`Installed ${SKILL_NAME} skill to ${destDir}`);
} catch (err) {
// Non-fatal — some agent directories may not exist or be writable
console.warn(`Skipped ${destDir}: ${err.message}`);
}
}
MIT License
Copyright (c) 2025 jpeggdev
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
{
"name": "@jpeggdev/humanize-writing",
"version": "2.0.0",
"description": "Claude Code skill that rewrites AI-generated content to sound human. Detects and fixes AI writing patterns including significance inflation, formulaic structure, AI vocabulary, grammar-level tells, robotic rhythm, hedging, and missing personality.",
"main": "index.js",
"scripts": {
"postinstall": "node install-skill.js",
"preuninstall": "node uninstall-skill.js"
},
"keywords": [
"claude",
"skill",
"agent",
"writing",
"humanize",
"ai-detection"
],
"author": "jpeggdev",
"license": "MIT",
"repository": {
"type": "git",
"url": "git+https://github.com/jpeggdev/humanize-writing.git"
},
"files": [
"SKILL.md",
"references/",
"install-skill.js",
"uninstall-skill.js"
]
}
humanize-writing
A Claude Code skill that rewrites AI-generated content to sound like a human wrote it.
What it does
Detects and fixes common AI writing patterns through an 8-pass editing process:
1. Structure tells -- formulaic sections, identical list lengths, tidy takeaways 2. Significance inflation / promotional language -- "pivotal moment," "nestled," "vibrant" 3. AI vocabulary -- "delve," "landscape," "leverage," "tapestry," and dozens more 4. Grammar-level patterns -- copula avoidance, -ing phrases, synonym cycling, false ranges 5. Rhythm and style -- metronomic cadence, em dash overuse, boldface, emoji, curly quotes 6. Hedging, filler, and vague attributions -- "It's worth noting," chatbot artifacts, sycophancy 7. Connective tissue -- "Moreover," "Furthermore," "Additionally" on repeat 8. Human texture and soul -- adding opinions, lived experience, personality
See SKILL.md for the full editing process and references/ai-tells.md for the complete detection checklist.
Install
Via skills.sh (GitHub-based)
npx skills add jpeggdev/humanize-writingVia npm
npm install -g @jpeggdev/humanize-writingThe postinstall script copies the skill files to ~/.claude/skills/humanize-writing/ (and equivalent directories for Cursor and Windsurf).
Usage
Once installed, the skill activates automatically in Claude Code when you say things like:
- "humanize this"
- "sounds like AI"
- "make it sound human"
- "too robotic"
- "de-AI this"
Credits
This skill combines two approaches:
- The pass-based editing workflow and ai-tells reference from humanize-writing
- The 24 Wikipedia-sourced patterns and "soul" philosophy from humanizer by blader
Primary reference: Wikipedia: Signs of AI writing, maintained by WikiProject AI Cleanup.
Version History
- 2.0.0 - Combined humanize-writing and humanizer-blader into a single skill. Added passes for significance inflation, grammar-level patterns, and soul/personality. Expanded ai-tells.md with additional patterns.
- 1.0.1 - npm packaging fixes
- 1.0.0 - Initial release
Uninstall
npm uninstall -g @jpeggdev/humanize-writingThis removes the skill files from all agent skill directories.
License
MIT
AI Writing Tells
Patterns, words, and structures that signal AI-generated content. Organized by category.
---
Vocabulary: Words AI Overuses
Tier 1: Immediate Red Flags
These words almost never appear in natural human writing at the frequency AI uses them.
| AI Word/Phrase | Human Alternative |
|---|---|
| Delve / delve into | Look at, dig into, explore |
| Landscape (metaphorical) | Scene, world, space, field -- or just drop it |
| Tapestry / rich tapestry | (delete entirely) |
| Paradigm shift | Big change, sea change |
| Fundamental shift | Things changed, the ground moved |
| Game-changer | (be specific about what changed) |
| Leverage (verb) | Use |
| Harness | Use, take advantage of |
| Navigate (metaphorical) | Deal with, figure out, handle |
| Realm | Area, field, world |
| Embark on a journey | Start, begin |
| Myriad | Many, a lot of |
| Plethora | Many, plenty of |
| Multifaceted | Complex, varied |
| Groundbreaking | New, first-of-its-kind |
| Revolutionize | Change, reshape, overhaul |
| Synergy | (be specific about what's combining) |
| Ecosystem (non-technical) | World, space, community |
| Resonate | Connect, land, hit home |
| Streamline | Simplify, speed up, cut steps from |
| Testament | (delete -- just state the evidence) |
| Enduring | Lasting, long-running |
Tier 2: Suspicious in Clusters
Fine alone, but AI uses these in combination. Three or more in one piece is a tell.
| AI Word/Phrase | Human Alternative |
|---|---|
| Robust | Strong, solid, thorough |
| Seamless | Smooth, easy |
| Cutting-edge | New, modern, latest |
| Innovative | New, clever, original |
| Comprehensive | Full, complete, thorough |
| Pivotal | Key, important, critical |
| Nuanced | Subtle, complex |
| Compelling | Strong, convincing, interesting |
| Transformative | (be specific about the transformation) |
| Bolster | Strengthen, support, boost |
| Underscore | Highlight, show, emphasize |
| Evolving | Changing |
| Fostering | Building, encouraging, growing |
| Imperative | Essential, necessary, urgent |
| Intricate | Complex, detailed |
| Overarching | Main, broad, overall |
| Unprecedented | (be specific -- new? first? biggest?) |
| Vibrant | Lively, active, busy |
| Profound | Deep, significant |
| Renowned | Well-known, famous |
| Stunning | (be specific about what's impressive) |
| Showcasing | Showing, displaying, demonstrating |
| Exemplifies | Shows, demonstrates |
| Garner | Get, earn, attract |
| Valuable | Useful, helpful, worth doing |
---
Phrases: Sentence Starters and Filler
"It's worth..." Family
- "It's worth noting that..." -> Just state the thing.
- "It's important to note..." -> Just state the thing.
- "It's crucial to understand..." -> Just state the thing.
- "It bears mentioning..." -> Just state the thing.
"In today's..." Family
- "In today's fast-paced world..." -> (delete)
- "In today's digital landscape..." -> (delete)
- "In today's competitive market..." -> (delete)
- "In an era of..." -> (delete or be specific)
"At its core..." Family
- "At its core..." -> (delete or restructure)
- "At the end of the day..." -> (delete or replace with "ultimately" if you must)
- "When all is said and done..." -> (delete)
Hedging Starters
- "While there are certainly..." -> Pick a side.
- "To be sure..." -> (delete)
- "That said..." -> "But" (once per piece max)
- "This is not without its challenges..." -> Name the challenge directly.
- "It remains to be seen..." -> "We don't know yet" or (delete)
AI Closers
- "The bottom line is..." -> (just make your point)
- "Only time will tell..." -> (delete)
- "The future is bright..." -> (delete or be specific)
- "Start your journey today" -> (be specific about the action)
- "Exciting times lie ahead" -> (delete)
Filler Phrases
- "In order to" -> "To"
- "Due to the fact that" -> "Because"
- "At this point in time" -> "Now"
- "In the event that" -> "If"
- "Has the ability to" -> "Can"
- "It is important to note that" -> (delete, just state it)
Sycophantic / Chatbot Artifacts
- "Great question!" -> (delete)
- "Certainly!" / "Absolutely!" -> (delete)
- "I hope this helps!" -> (delete)
- "Let me know if you'd like me to expand" -> (delete)
- "You're absolutely right!" -> (delete)
Knowledge-Cutoff Disclaimers
- "As of [date]..." -> Only a tell when it corresponds to a model training cutoff or hedges instead of citing. Normal in journalism for time-sensitive data.
- "While specific details are limited..." -> (delete or find source)
- "Based on available information..." -> (delete)
---
Significance Inflation
Words and phrases that puff up importance beyond what the content warrants.
| Inflation Pattern | What to do |
|---|---|
| "marking a pivotal moment in the evolution of" | State what happened, not its cosmic significance |
| "stands/serves as a testament to" | Delete. State the evidence directly. |
| "underscores/highlights its importance" | Delete. The importance should be self-evident. |
| "reflects broader trends" | Name the specific trend or delete. |
| "setting the stage for" | Say what actually happened next. |
| "represents a shift" / "key turning point" | Be specific about what changed. |
| "indelible mark" / "deeply rooted" | (delete or be specific) |
---
Grammar-Level Patterns
Copula Avoidance
AI substitutes elaborate verbs for "is"/"are"/"has." The tell is when these cluster -- a piece that never uses "is" is suspicious. A single "serves as" in formal writing is normal:
| AI Construction | Human Alternative |
|---|---|
| serves as | is |
| stands as | is |
| represents | is |
| marks | is |
| boasts | has |
| features | has |
| offers | has |
Superficial -ing Phrases
AI tacks participle phrases onto sentences for fake depth:
- "highlighting the importance of..."
- "underscoring the need for..."
- "emphasizing the significance of..."
- "reflecting the broader trend..."
- "symbolizing the community's..."
- "showcasing how..."
- "contributing to..."
- "fostering a sense of..."
- "encompassing..."
Fix: Delete the phrase, or expand into its own sentence with an actual source.
Negative Parallelisms
"Not only... but also..." and "It's not just about X, it's about Y."
Fine in moderation. AI uses it 5-10 times per piece. The tell is density relative to length, not an absolute count.
Rule of Three
AI forces ideas into groups of three where the third item is padding. Tricolons are a natural rhetorical device -- only flag when the third item adds nothing or is a near-synonym of the first two.
Synonym Cycling
AI uses different words for the same thing to avoid repetition: "protagonist... main character... central figure... hero" all in one paragraph. Pick one term and stick with it.
False Ranges
"From X to Y" where X and Y aren't on a meaningful scale. Just list the topics.
---
Structure: Patterns That Reveal AI
The Formulaic Section
Every section follows: Setup -> Explanation -> "What this means for you" / "The takeaway"
Fix: Vary endings. Some sections end with a question. Some end mid-thought. Some just stop.
The Parallel List
AI makes every bullet point the same grammatical structure and similar length.
Fix: Let some bullets be short. Let some be a full sentence. Break one into a sub-list if it needs it.
The Tricolon Close
"Start building, start learning, start growing."
Fix: Use a single direct statement instead. Or just two items.
The Balanced Conclusion
"The gap between X and Y is widening. The good news: [positive]. The challenge: [negative]. [Inspiring closer.]"
Fix: End with one strong statement, not a perfectly balanced assessment.
Em Dash Usage
The tell is both frequency and function. Count before flagging -- don't assume density from a general impression.
- Frequency: More than one em dash per 3-4 paragraphs is above human baseline
- Function: Even a single em dash is a tell if it's doing the classic AI move: injecting a dramatic explanatory aside mid-sentence (e.g., "the system -- designed to handle millions of requests -- struggled under load")
Fix: Use periods. Use commas. Actually count em dashes before claiming overuse.
---
Tone: The AI "Voice"
Too Balanced
AI always presents both sides. Real writers with expertise pick a position and defend it.
Too Positive
AI defaults to optimism. "Exciting developments," "tremendous opportunity," "bright future." Real writing is more measured and occasionally pessimistic.
Too Smooth
AI never stumbles, pauses, or doubles back. Real writing has slight roughness -- a parenthetical aside, a sentence that starts one way and pivots, a blunt statement after a complex one.
No Personality
AI doesn't have opinions, pet peeves, or a sense of humor. Adding these (sparingly) makes writing feel authored by someone real.
---
Detection Heuristic
Score the piece on these dimensions. 5+ hits = likely AI-generated:
- [ ] Uses 3+ Tier 1 vocabulary words
- [ ] Uses 5+ Tier 2 vocabulary words
- [ ] Has "It's worth noting" or similar filler phrases
- [ ] Every section follows the same structure
- [ ] "Not X, but Y" appears more than twice
- [ ] Em dashes appear more than once per 3-4 paragraphs, or a single em dash injects a dramatic aside
- [ ] No sentences under 8 words
- [ ] No informal or colloquial language anywhere
- [ ] Conclusion is perfectly balanced (good news/bad news/inspiring close)
- [ ] Every list has the same number of items
- [ ] No opinions, asides, or personality
- [ ] Every claim is hedged with "certainly" or "to be sure"
- [ ] Uses copula avoidance ("serves as" instead of "is") multiple times
- [ ] Significance inflation in opening or closing paragraphs
- [ ] Chatbot artifacts present ("I hope this helps!")
const fs = require("fs");
const path = require("path");
const os = require("os");
const SKILL_NAME = "humanize-writing";
const SKILL_DIRS = [
path.join(os.homedir(), ".claude", "skills", SKILL_NAME),
path.join(os.homedir(), ".cursor", "skills", SKILL_NAME),
path.join(os.homedir(), ".windsurf", "skills", SKILL_NAME),
];
for (const dir of SKILL_DIRS) {
try {
if (fs.existsSync(dir)) {
fs.rmSync(dir, { recursive: true });
console.log(`Removed ${SKILL_NAME} skill from ${dir}`);
}
} catch (err) {
console.warn(`Skipped ${dir}: ${err.message}`);
}
}
Related skills
How it compares
Pick humanize-writing to de-AI existing drafts; pick copywriting generator skills when starting from a blank page.
FAQ
What version is humanize-writing?
humanize-writing is version 2.0.0, detecting inflated significance, promotional tone, formulaic structure, AI vocabulary, hedging, and em dash overuse using Wikipedia's Signs of AI writing guide.
What content types does humanize-writing edit?
humanize-writing revises blogs, landing pages, emails, and product copy via Read and Write tools, reshaping robotic AI prose into natural human voice while preserving factual content.
Is Humanize Writing safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.