humanize-writing

jpeggdev/humanize-writing · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/jpeggdev/humanize-writing --skill humanize-writing
0 commentsdiscussion
summary

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.

skill.md

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 d

how to use humanize-writing

How to use humanize-writing on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add humanize-writing
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/jpeggdev/humanize-writing --skill humanize-writing

The skills CLI fetches humanize-writing from GitHub repository jpeggdev/humanize-writing and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/humanize-writing

Reload or restart Cursor to activate humanize-writing. Access the skill through slash commands (e.g., /humanize-writing) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

User Story & Requirements Generation

Create detailed user stories, acceptance criteria, and feature specs

Example

Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios

Reduce spec writing time by 50%, ensure comprehensive coverage

Competitive Analysis

Research competitors, compare features, identify gaps

Example

Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities

Complete competitive research in 2 hours instead of 2 days

Roadmap Prioritization

Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs

Example

Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale

Make data-driven prioritization decisions faster

Stakeholder Communication

Draft PRDs, status updates, and stakeholder presentations

Example

Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement

Save 3-5 hours/week on communication overhead

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client
  • Access to product documentation and roadmap tools (Jira, Notion, etc.)
  • Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
  • Stakeholder contact information and communication channels

Time Estimate

30-60 minutes to see productivity improvements

Installation Steps

  1. 1.Install product management skill
  2. 2.Start with user story generation for known feature
  3. 3.Progress to competitive analysis: research 2-3 competitors
  4. 4.Use for roadmap prioritization: apply RICE/ICE scoring
  5. 5.Draft stakeholder communications and refine based on feedback
  6. 6.Build template library for recurring PM tasks
  7. 7.Share effective prompts with product team

Common Pitfalls

  • Not validating competitive research—verify facts before sharing
  • Accepting user stories without involving engineering team
  • Over-relying on frameworks without qualitative judgment
  • Not customizing outputs to company culture and communication style
  • Skipping stakeholder validation of generated requirements

Best Practices

✓ Do

  • +Validate research and competitive analysis with real data
  • +Collaborate with engineering when generating technical requirements
  • +Customize frameworks and templates to your company context
  • +Use skill for first drafts, refine with stakeholder input
  • +Document successful prompt patterns for PM tasks
  • +Combine AI efficiency with human judgment and intuition

✗ Don't

  • Don't publish competitive analysis without fact-checking
  • Don't finalize user stories without engineering review
  • Don't make prioritization decisions solely on AI scoring
  • Don't skip customer validation of generated requirements
  • Don't ignore company-specific context and culture

💡 Pro Tips

  • Provide context: company goals, constraints, customer feedback
  • Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
  • Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
  • Use skill for 70% generation + 30% customization to company needs

When to Use This

✓ Use When

Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.

✗ Avoid When

Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.

Learning Path

  1. 1Basic: user stories, feature specs, status updates
  2. 2Intermediate: competitive analysis, prioritization frameworks, PRDs
  3. 3Advanced: product strategy, go-to-market planning, OKR setting
  4. 4Expert: product vision, market positioning, business model innovation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.536 reviews
  • Chaitanya Patil· Dec 28, 2024

    I recommend humanize-writing for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Hiroshi Perez· Dec 16, 2024

    humanize-writing reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Ira Abbas· Dec 4, 2024

    humanize-writing is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Amelia Gill· Nov 23, 2024

    Keeps context tight: humanize-writing is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Piyush G· Nov 19, 2024

    humanize-writing fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Hiroshi Gonzalez· Nov 19, 2024

    humanize-writing has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Rahul Santra· Nov 11, 2024

    Useful defaults in humanize-writing — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Harper Farah· Nov 7, 2024

    We added humanize-writing from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Sofia Bhatia· Oct 26, 2024

    Keeps context tight: humanize-writing is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Ira Choi· Oct 14, 2024

    We added humanize-writing from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

showing 1-10 of 36

1 / 4