SupportDoc rewrite

Rewrite a confusing help article for clarity

Use when an existing help-center article generates tickets because customers cannot follow it.

The prompt
prompt.txt
You are a documentation editor fixing a help article that confuses readers.

Current article: {{current_article}}
What customers misunderstand or get stuck on: {{confusion_points}}
Reader skill level: {{reader_level}}

Rewrite the article so it:
1. Opens with what the reader will accomplish and when to use this.
2. Breaks the process into one-action numbered steps with exact UI labels in bold.
3. Removes assumed knowledge and defines any necessary term inline.
4. Adds a short troubleshooting section for the points people get stuck on.
5. Uses headings so it is skimmable.

Output the rewritten article, then a 3-bullet changelog of what you fixed and why.

Click the copy button in the top right of the block to grab the full prompt.

Variables

Replace each placeholder below with your own values before you run the prompt.

  • {{current_article}}
  • {{confusion_points}}
  • {{reader_level}}
Recommended models
Claude Opus 4.8GPT-5Gemini 2.5 Pro
Tags
#help-docs#rewrite#clarity#knowledge-base

Related prompts

SupportEmpathetic reply
Write an empathetic first reply to an upset customer

You are a senior customer support agent for {{company}}. Write a first reply to this message from an upset customer. Customer message: """ {{customer_message}} """ Requirements: -...

Claude Opus 4.8GPT-5Gemini 2.5 Pro
#empathy#reply#deescalation#tone
View
SupportShipping delay
Reply to a customer about a shipping delay

Write a support reply about a delayed order for {{company}}. Details: - Order number: {{order_number}} - Original delivery estimate: {{original_eta}} - New realistic estimate: {{ne...

Claude Opus 4.8GPT-5Gemini 2.5 Pro
#shipping#reply#ecommerce#delay
View
SupportRefund approval
Write a reply approving a refund

Write a support reply confirming an approved refund for {{company}}. Details: - Customer name: {{customer_name}} - Amount: {{refund_amount}} - Payment method refunded to: {{payment...

Claude Opus 4.8GPT-5Gemini 2.5 Pro
#refund#reply#billing#confirmation
View
SupportRefund decline
Decline a refund request politely with reasons

Write a support reply that politely declines a refund for {{company}}. Context: - What the customer asked for: {{request}} - Policy that applies: {{policy}} - Why it does not quali...

Claude Opus 4.8GPT-5Gemini 2.5 Pro
#refund#policy#reply#deescalation
View
SupportChurn save
Write a churn-save email for a canceling customer

Write a churn-save email for {{company}} aimed at a customer who is canceling. Context: - Plan they are on: {{plan}} - Stated cancel reason: {{cancel_reason}} - Best save offer you...

Claude Opus 4.8GPT-5Gemini 2.5 Pro
#churn#retention#email#saas
View
SupportMacro pack
Generate a pack of canned response macros

You are setting up canned response macros for {{company}}'s help desk. Create {{count}} reusable macros covering these common topics: {{topics}} For each macro provide: - A short i...

Claude Opus 4.8GPT-5Gemini 2.5 Pro
#macros#templates#helpdesk#efficiency
View

0 Comments

Sign in to post

Loading discussion...