Get the FREE Ultimate OpenClaw Setup Guide →

writing-prose-like-a-human

Scanned
npx machina-cli add skill kylehughes/writing-prose-like-a-human-for-agents/writing-prose-like-a-human --openclaw
Files (1)
SKILL.md
12.5 KB

Writing Prose Like a Human

Core Principle

AI writing has a statistical signature: regression to the mean. Models replace specifics with generalities, inflate importance with stock phrases, and smooth over the uneven texture that makes human writing feel real. The result reads like a press release about everything.

Human writing is specific, uneven, and comfortable with imperfection. A human writer says "the bridge opened in 1973" where an AI says "the bridge stands as a testament to the region's rich engineering heritage." A human writer says "I don't know" where an AI says "while specific details remain limited in available sources."

The antidote is concrete detail and restraint. Say what happened. Skip the commentary about why it matters. Trust the reader to draw their own conclusions.

The Five Rules

1. Be specific, not significant

State facts without editorializing their importance. Cut words that inflate: "pivotal", "crucial", "vital", "key" (as adjective), "testament", "watershed", "indelible mark", "deeply rooted", "groundbreaking" (figurative), "lasting legacy", "broader movement." Let facts carry their own weight.

Before:

The 1987 renovation played a pivotal role in shaping the building's enduring legacy, serving as a testament to the community's deeply rooted commitment to architectural preservation.

After:

The building was renovated in 1987. The city council funded the project after the roof collapsed during a storm.

The second version is more informative. The first version says the renovation was important without saying why.

2. Use plain verbs

Write "is", "are", "has" instead of "serves as", "stands as", "represents." Write "shows" not "showcases", "stresses" not "underscores", "has" not "boasts" or "features." Plain copulas are the backbone of clear prose. Don't replace them with verbs that sound more impressive but mean the same thing.

Better yet, find the active verb hiding inside the noun phrase. "The tool serves as a validation mechanism" becomes "The tool is a validation mechanism" (better), which becomes "The tool validates inputs" (best).

Before:

The museum showcases an extensive collection that encompasses works from diverse artistic movements, offering visitors a glimpse into the region's vibrant cultural tapestry.

After:

The museum has paintings from the 16th through 20th centuries, mostly Dutch and Flemish.

3. End sentences at the fact

Do not append participial commentary — those "-ing" phrases that editorialize after the main clause. "The population grew 12%, reflecting broader demographic trends" says less than "The population grew 12%." The participial phrase adds opinion disguised as analysis.

Watch for: "highlighting its importance", "reflecting broader trends", "underscoring the significance", "ensuring continued relevance", "emphasizing the need for", "solidifying its position as."

Before:

The company opened a second factory in 2019, highlighting its commitment to expanding operations and underscoring the region's growing economic significance.

After:

The company opened a second factory in 2019.

4. Vary your rhythm

Mix sentence lengths. Some sentences should be short. Others can run longer when the content demands it, but length should follow from the complexity of the idea, not from a habit of packing three clauses into every sentence.

Don't default to the rule of three. Two items or four items are fine. One is fine. Don't use "Not only X but Y" as a crutch — keep it to one per document at most, if at all. Don't open consecutive sentences with "Additionally," "Furthermore," or "Moreover."

Before:

Not only does the festival celebrate local traditions, but it also fosters community engagement, promotes cultural awareness, and attracts visitors from across the region. Additionally, it serves as a platform for emerging artists. Furthermore, it contributes to the local economy.

After:

The festival runs for three days each September. About 200 local vendors set up stalls. Attendance has been around 15,000 since 2018.

5. Earn every adjective

Cut "vibrant", "rich" (cultural), "profound", "intricate", "enduring", "bustling", "stunning", "breathtaking", "dynamic", "meticulous", "robust", "comprehensive", "seamless", "multifaceted" unless they carry specific, non-decorative meaning. If removing the adjective doesn't change the meaning, remove it.

The test: does the adjective tell the reader something they couldn't infer from the noun? "A tall building" works because not all buildings are tall. "A vibrant community" fails because the writer means "a community" — the adjective is decoration.

Before:

Nestled in the heart of the vibrant downtown district, the bustling market offers a rich tapestry of diverse culinary experiences.

After:

The market is on 4th Street between Pine and Oak. It has about 30 food stalls.

Vocabulary Watchlist

These words and phrases appear at statistically elevated rates in LLM output. Their presence alone doesn't prove AI authorship, but clusters of them are a strong signal. When you catch yourself reaching for one, pause and ask whether a plainer word works.

Significance inflation

AvoidWrite instead
pivotal, crucial, vitalimportant (or cut entirely)
key (adjective)main, or rephrase
testament (to)evidence, or cut
watershed moment(state what changed)
indelible mark(state the effect)
deeply rootedlong-standing, or cut
lasting/enduring legacy(state what persists)
broader movement(name the movement)
evolving landscape(state what changed)
focal pointcenter, focus
tapestry (abstract)(cut — describe the actual thing)
groundbreaking (figurative)new, first, original
captivateinterest, draw
plays a significant rolematters, affects
reminder (as in "is a reminder")evidence, sign, or cut
key turning pointstate what changed
marks/represents a shiftstate what changed
contributing to thestate the contribution, or cut

False sophistication

AvoidWrite instead
delve (into)look at, examine, discuss
intricatedetailed, complex
interplayrelationship, interaction
garnerget, receive, earn
underscore (verb)stress, show
showcaseshow, display, has
fosterencourage, support
encompassinclude, cover
align (with)match, agree with, fit
resonate (with)appeal to, affect
vibrant(cut, or be specific)
enduringlong-lasting, or cut
enhanceimprove
nestledlocated, situated, is in
in the heart ofin, in central
boastshas
navigatehandle, manage, deal with
leverageuse
elevateraise, improve
reimagineredesign, rethink
orchestrateorganize, arrange
paradigmmodel, approach
robuststrong, reliable
seamlesssmooth
meticulouscareful, thorough
multifacetedcomplex, varied
bespokecustom
facilitatehelp, enable, allow
instrumentalimportant, useful
highlight (verb)show, point out
exemplifyshow, illustrate
cultivate (figurative)build, encourage
intricaciesdetails, complexities
valuableuseful, or cut
renownedwell-known, or cut
featuringwith, including, has

Structural tics

AvoidWrite instead
Additionally, (sentence opener)(cut, or restructure)
Furthermore,(cut, or restructure)
Moreover,(cut, or restructure)
However, (overused)but, or restructure
Therefore, (overused)so, or restructure
It is worth noting(just state the thing)
It's important to remember(just state the thing)
Despite these challenges,(state the challenge directly)
reflects broader(name what it reflects)
setting the stage forbefore, leading to
marking/shaping the(rephrase without gerund)
Not only X but Y(use sparingly — max 1 per doc)
In today's fast-paced world(cut entirely)
In the realm/world ofin
At its core(cut, or just state the thing)
A delicate balance(describe the actual trade-off)
It is not just about X, it's Y(rephrase without the negation setup)
Challenges and Legacy (as heading)(avoid as section title)
Future Outlook (as heading)(avoid as section title)
While specific details are limitedstate what's known, or say "unknown"
based on available information(cut — just state the information)

Vague attribution

AvoidWrite instead
Industry reports suggest(name the report)
Experts/observers/critics argue(name the person)
Some critics argue(name the critic, or cut)
several sources/publications(name them, or say "two" if there are two)
such as (before exhaustive lists)(just list the items — don't imply more exist)
profiled in(say what the profile said, or cut)
active social media presence(state follower count or cut)
independent coverage(name the outlet and what it said)

Structural Patterns to Avoid

  • Don't end sections with summaries. No "In summary", "In conclusion", "Overall." If the section made its point, stop.
  • Don't write the "challenges and future" formula. "Despite X, Y faces challenges... but the future looks promising" is the most recognizable AI paragraph structure. State problems directly without the redemptive arc.
  • Don't create exhaustive bold-header bullet lists for everything. "Scalability: The system scales well" wastes the reader's time. Use prose when content flows naturally; reserve bullet lists for genuinely list-shaped data.
  • Don't overuse em dashes for emphasis. One or two per page is fine. More than that reads as a stylistic tic. Prefer commas, parentheses, or colons.
  • Don't inflate attribution. "Featured in The New York Times and profiled by CNN" — if the citations matter, say what the sources said. If they don't, cut them.
  • Don't create small decorative tables. Tables work when data has two or more dimensions. For two or three items, prose is clearer.
  • Don't write false ranges. "From X to Y" requires X and Y to be endpoints of a real scale. "From biology to politics" is not a range.
  • Don't use title case in headings unless the style guide requires it. Sentence case reads more naturally.
  • Prefer straight quotation marks. Some AI models (notably ChatGPT and DeepSeek) default to curly quotes ("\u2026") and curly apostrophes (\u2019). Use straight quotes ("...") and straight apostrophes (') for consistency, unless the style guide specifies otherwise.
  • Don't moralize or append safety padding. "It is crucial to approach this topic with sensitivity" and "We must remember the human cost" are AI-generated moral wrappers. State the facts. If the facts are serious, the reader will notice without being told how to feel.

What Human Writing Actually Sounds Like

Human prose has positive characteristics that AI rarely reproduces:

  • Uneven sentence and paragraph length. Some paragraphs are one sentence. Some run long. The variation isn't random — it follows the shape of the ideas.
  • Comfortable use of "is" and "are." Plain copulas are fine. "The bridge is 200 meters long" needs no synonym for "is."
  • Natural repetition over forced variation. "The bridge was built in 1910. The bridge connects the north and south banks" is better than "The structure... the span... the crossing." Elegant variation is a trap.
  • Opinions stated plainly. "This approach is simpler" beats "Not only is this approach more elegant, but it also serves as a more maintainable solution."
  • Incomplete knowledge acknowledged directly. "The date is unknown" instead of "While specific details regarding the precise date remain limited in currently available sources."
  • Specificity over generality. A concrete fact ("the budget was $2.4 million") is worth more than a vague claim of significance ("a substantial investment reflecting the community's commitment").
  • Willingness to leave things unsaid. Not every paragraph needs a concluding sentence. Not every topic needs a transition.

Reference

For the complete guide with full examples, structural patterns, and the exhaustive vocabulary reference, see REFERENCE.md.

Source

git clone https://github.com/kylehughes/writing-prose-like-a-human-for-agents/blob/main/skills/writing-prose-like-a-human/SKILL.mdView on GitHub

Overview

This skill helps you produce prose that feels authentically human by avoiding the statistical patterns common to AI output. It emphasizes concrete detail, restraint, and plain language to keep tone natural. Ideal for prose, documentation, READMEs, PR descriptions, and any text where you cannot risk AI-like cadence.

How This Skill Works

It identifies signals of AI style such as hedging, generalized adjectives, and trailing commentary and rewrites them as concrete facts with plain verbs. It follows the five rules: be specific, use plain verbs, end sentences at the fact, vary rhythm, and trust the reader rather than overtly explaining significance. The process moves from verbose, opinionated phrasing to crisp statements that invite readers to draw conclusions.

When to Use It

  • Writing or editing documentation, READMEs, or PR descriptions that must not read like AI-generated content
  • Drafting product specs or technical docs requiring precise, concrete detail
  • Revising internal emails or communications where a human voice is essential
  • Polishing code comments or developer notes to avoid generic AI language
  • Crafting user guides or release notes that present facts clearly without glossy prose

Quick Start

  1. Step 1: Identify spots in your draft that rely on generic or AI-like language.
  2. Step 2: Rewrite those spots using concrete details and plain verbs, ending with the factual clause.
  3. Step 3: Read aloud and adjust rhythm until the prose sounds human while preserving meaning.

Best Practices

  • Be specific, not significant — state facts plainly and cut filler adjectives
  • Use plain verbs — prefer is, are, has over serves as, represents, or showcases
  • End sentences at the fact — avoid trailing participial phrases
  • Vary your rhythm — mix short and longer sentences to suit idea complexity
  • Trust the reader — skip explaining why it matters; let readers draw conclusions

Example Use Cases

  • Be specific: The building was renovated in 1987. The city council funded the project after the roof collapsed during a storm.
  • Use plain verbs: The museum has paintings from the 16th through 20th centuries, mostly Dutch and Flemish.
  • End sentences at the fact: The company opened a second factory in 2019.
  • Vary rhythm: The plan was ambitious. It faced delays. The team adapted and delivered.
  • Trust the reader: The note contains only facts; it invites readers to infer the impact.

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers