---
name: review-text-clarity-prompt
description: A prompt that edits your text for clarity, grammar, flow and tone while keeping your meaning and language, then lists the main changes so you can learn from them. Use when the user wants to proofread, fix grammar, make writing clearer, polish an email or blog post, or improve their writing.
license: MIT
metadata:
  category: writing-prompts
  tags: "copywriting,quality"
  author: johnny-bravo
  version: "1.0"
  updated: "2026-10-31"
  status: published
  source_url: "https://github.com/danielmiessler/Fabric/blob/8ce0909d8622a61b6aaf539d467ba31bb7e0b6dd/data/patterns/improve_writing/system.md"
  source_license: MIT
  copyright: "Copyright (c) 2012-2024 Scott Chacon and others"
  original_author: "Daniel Miessler and Fabric contributors (improve_writing pattern)"
  modified: "Converted by TheSkillVault into a fill-in prompt: added audience and tone inputs, an optional change list, steps, safety and done-when sections."
  imported_on: "2026-10-31"
---

# Review text for clarity (prompt)

## When to use
- Polishing an email, blog post, landing page copy, README or essay.
- Fixing grammar and awkward sentences without losing your voice.
- Writing in a second language and wanting a natural-sounding version.

## Steps
1. Fill in {{AUDIENCE}} and {{TONE}} (for example "customers" and "friendly but direct").
2. Paste your text in place of {{TEXT}}.
3. Read the edited text aloud. Keep the changes that sound like you.
4. Use the change list to spot your own repeat mistakes.

## Prompt
```text
You are an expert editor. Improve the text below for clarity, flow, grammar and style.
Audience: {{AUDIENCE}}. Tone: {{TONE}}.

Rules:
1. Keep the original meaning, facts and intent. Do not add new claims.
2. Reply in the same language as the text.
3. Prefer short sentences, plain words and active voice.
4. Keep the author's voice. Do not make it sound like marketing unless asked.

Output:
- EDITED TEXT: the improved version.
- CHANGES: up to 5 bullets naming the most important kinds of change you made.

TEXT:
{{TEXT}}
```

## How to adapt
- Only want the clean text? Delete the CHANGES line.
- For a strict proofread, replace rule 3 with "fix only spelling, grammar and punctuation".

## Gotchas
- Editors sometimes change meaning. Compare numbers, names and promises with your original.
- Remove passwords, private customer details and anything confidential before pasting.
- Works with any chat AI (ChatGPT, Claude, Gemini or others). No tool lock-in.

## Done when
- The edited text says the same thing as your original, more clearly.
- You have read it aloud once and it sounds like you.

## Example prompt
"Proofread this email to a client and make it clearer, but keep my tone."

---
Converted from the "improve_writing" pattern in danielmiessler/Fabric (MIT, Copyright (c) 2012-2024 Scott Chacon and others). See LICENSE.txt.