Audit a Help Center Article for Gaps, Jargon and Outdated Steps

Paste a help center article and get a pass/fail checklist scorecard plus a line-by-line fix list ranked by customer impact, without a full rewrite.

You getScorecard, fix list and split recommendation

Prompt

Prompt
You are a help center content lead who audits support articles before they are republished.

I will paste an existing help center article right after this message. Audit it for gaps, jargon and outdated steps. Do not rewrite the whole article. Give targeted fixes only.

Rules:
1. Score the article against this checklist, marking each item Pass, Partial or Fail with a one-line reason: one task per article, title names the task, numbered steps with one action each, UI labels written exactly and in bold, screenshots noted where a step is ambiguous, prerequisites listed first, last-verified date present, related articles linked.
2. Quote the exact line for every issue before the fix, so I can find it with Ctrl+F.
3. Flag any term a new customer would not know and give a plain replacement.
4. Mark steps that look outdated (old menu names, removed features, version numbers) as "Verify in product" instead of guessing the current UI.
5. Rank each fix: High (blocks the task), Medium (causes confusion), Low (polish).

Output format:
1. Scorecard: table with columns Check, Result, Reason, then a total out of 8.
2. Fix list: table with columns #, Quoted line, Problem, Fix, Priority.
3. Split recommendation: if the article covers more than one task, list proposed separate article titles.
4. Three quick wins to do today.

End by listing what you could not check without access to the live product.

Example output

Example for: a 410-word article titled "Invoices" from a fictional billing app, Ledgerly, last edited in 2022.

1. Scorecard

CheckResultReason
One task per articleFailCovers exporting invoices and setting up auto-send
Title names the taskFail"Invoices" says nothing about what the reader will do
Numbered steps, one action eachPartialSteps 2 and 4 each contain three actions
UI labels exact and boldPartial"Export button" not bolded; "Settings area" is vague
Screenshots notedFailNo visuals for the date-range picker
Prerequisites firstFailAdmin role requirement appears in the last paragraph
Last-verified dateFailOnly "Updated 2022" with no verification note
Related articles linkedPassLinks to "Understanding invoice statuses"

Total: 1 of 8 (plus 2 Partial)

2. Fix list

#Quoted lineProblemFixPriority
1"Only workspace admins can do this."Prerequisite buried at the endMove to a Before you start box at the topHigh
2"Go to the Billing Hub tab"Possibly renamed menuVerify in productHigh
3"Select your range, choose CSV, and hit Export."Three actions in one stepSplit into steps 3, 4 and 5Medium
4"Exports are generated asynchronously."Jargon"Your file is prepared in the background and emailed to you within a few minutes."Medium
5"Use the date-range picker"Ambiguous control, no visualAdd screenshot of the picker with the start date highlightedMedium
6"Supports v2 export format"Version reference may be outdatedVerify in productMedium
7"Invoices" (title)Not task-based"Export Your Invoices to CSV or PDF"Low

3. Split recommendation

  • Export Your Invoices to CSV or PDF
  • Send Invoices Automatically to Customers

4. Quick wins for today

  1. Move the admin requirement to the top.
  2. Retitle the article to name the task.
  3. Add a "Last verified" line with today's date once steps 2 and 6 are checked.

Could not check without the live product: whether "Billing Hub" still exists, whether v2 is the current export format, and whether export emails still arrive within minutes.

Written by AI from this prompt. Your results will vary.

Tips and common edits

Why this works

  • A fixed 8-point checklist gives a score you can compare across articles instead of a vague opinion.
  • Quoting each line before the fix lets writers find and patch issues fast without rereading the whole article.
  • "Verify in product" stops the model from inventing current menu names it cannot see.

Use before a quarterly help center review or after a product release. Copy the full article text, including the title and any update date, and paste it into ChatGPT, Claude or Gemini right after the prompt.

Common edits

  • Add your own style-guide rules to the checklist, such as voice, tone or reading level.
  • Paste several short articles at once and ask for one scorecard row per article.

Prompt details

By
Prompts-GPT editors
Published

Did this prompt work?

Keep exploring

More in Customer Support