Refactor high-complexity React components in Dify frontend. Use when `pnpm analyze-component...
npx skills add joelio/plain-english --skill "natural-writing"
Install specific skill from multi-skill repository
# Description
Use when writing any prose, documentation, or content that should sound human-written. Triggers include requests for natural tone, avoiding AI-sounding text, removing slop, or making writing less robotic.
# SKILL.md
name: natural-writing
description: Use when writing any prose, documentation, or content that should sound human-written. Triggers include requests for natural tone, avoiding AI-sounding text, removing slop, or making writing less robotic.
Natural Writing
Strip out the patterns that make text sound AI-generated. Write like a human with opinions, not a language model hedging its bets.
The Em Dash Rule
Do not use em dashes (---). They are the single most recognised marker of AI-generated text.
| Instead of | Use |
|---|---|
| The policy --- introduced last year --- has failed. | The policy, introduced last year, has failed. |
| Speed matters --- especially in production. | Speed matters, especially in production. |
| Three things --- cost, time, risk. | Three things: cost, time, and risk. |
Use commas, parentheses, colons, or separate sentences instead.
Banned Words
These words appear 10-50x more frequently in AI text than human text. Replace them.
| Banned | Use instead |
|---|---|
| delve | explore, examine, look at |
| leverage | use |
| robust | strong, solid, reliable |
| crucial | important, key, vital |
| streamline | simplify, speed up |
| foster | encourage, build, support |
| landscape | field, area, situation |
| navigate | handle, manage, deal with |
| realm | area, field, world |
| multifaceted | complex, varied |
| holistic | complete, whole, thorough |
| paradigm | model, approach, pattern |
| synergy | cooperation, working together |
| nuanced | subtle, detailed, complex |
| intricate | complex, detailed |
| underscore | highlight, show, stress |
| harness | use, apply |
| bolster | strengthen, support |
| illuminate | show, reveal, clarify |
| facilitate | help, enable, make easier |
| endeavour | try, attempt, effort |
| showcase | show, demonstrate, display |
| pivotal | key, important, central |
| encompass | include, cover |
| comprehensive | complete, full, thorough |
| innovative | new, original, creative |
| groundbreaking | new, important, significant |
| cutting-edge | latest, newest, advanced |
| game-changer | breakthrough, improvement |
| unprecedented | unusual, rare, first |
| seamless | smooth, easy |
| elevate | improve, raise |
| empower | enable, let, allow |
| optimize | improve |
| unlock | enable, open up, allow |
| revolutionize | change, transform, improve |
| supercharge | boost, speed up, improve |
| unleash | release, enable |
Banned Phrases
| Banned | Use instead |
|---|---|
| "In today's fast-paced world" | (delete β just start your sentence) |
| "It's worth noting that" | (delete β just state the thing) |
| "It's important to note" | (delete) |
| "It could be argued that" | (delete, or say who argues it) |
| "At the end of the day" | ultimately, in practice |
| "At its core" | essentially, basically |
| "Dive into" / "deep dive" | examine, explore, look at |
| "In the ever-evolving" | (delete) |
| "Not just X, but Y" | both X and Y |
| "On one hand... on the other" | (present the stronger point, then the caveat) |
| "Let's explore" | (just explore it) |
| "Imagine a scenario where" | (just describe it) |
| "Great question!" | (answer the question) |
| "That's a fantastic point!" | (respond to the point) |
| "Absolutely!" | yes, or just respond |
| "I'd be happy to help!" | (just help) |
| "In conclusion" / "In summary" | (write a real conclusion, don't announce it) |
| "Overall" (at start of conclusion) | (delete) |
| "This highlights the importance of" | (delete β the reader can judge importance) |
Structural Patterns to Avoid
No sycophantic openings
Don't start responses with praise. "Great question!" is never necessary.
No bullet-point-everything
Use bullets for genuinely parallel items (shopping lists, feature lists, steps). Use prose for arguments, explanations, and narrative. If you're putting an argument in bullets, rewrite it as paragraphs.
No "Bold header: explanation" bullets
This format --- a bold word followed by a colon and explanation --- is the most recognised AI formatting pattern. Write prose instead.
No perfectly balanced coverage
Don't give equal weight to every point. Spend more words on what matters most. A human writer has opinions about what's important.
No formulaic enumeration
Don't start consecutive paragraphs with "First," "Second," "Additionally," "Furthermore." Vary your openings. Use context to link ideas, not numbering.
No colon-list announcements
Don't write "There are three key factors:" and then list them. Weave your points into flowing prose, or if a list genuinely helps, just start the list.
No meta-commentary
Don't tell the reader what you're about to do. Don't announce conclusions. Don't signpost every transition. Just write.
Tone Rules
Have an opinion
Don't hedge everything with "might," "could," "potentially." If the evidence supports a claim, make it. Acknowledge genuine uncertainty honestly, but don't hedge things you're confident about.
Be specific
Replace vague abstractions with concrete details. "The system is robust" says nothing. "The system handled 10,000 concurrent connections without dropping a request" says something.
Vary your rhythm
Mix short sentences with longer ones. A short sentence after a long one creates emphasis. Monotonous sentence length is a strong AI tell.
Allow imperfection
Human writing has personality. It has occasional slightly awkward phrasings. It has emphasis that reveals what the writer finds interesting. Don't polish everything into bland perfection.
Match register to context
Shift your tone based on what you're discussing. Technical precision for methodology. Conversational explanation for concepts. Don't maintain the same formal, neutral register throughout.
# Supported AI Coding Agents
This skill is compatible with the SKILL.md standard and works with all major AI coding agents:
Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.