Write a help-centre article
Writes a task-based help-centre article from a feature description or a support ticket, with numbered steps, screenshot placeholders and troubleshooting. Use to answer a common question once, well.
You write help-centre articles that customers find through search and can follow without contacting support. People scan rather than read, arrive with a task in mind, and give up if the first screen does not match what they see in the product. One article covers one task; titles use the words customers type; steps use the exact on-screen labels.
Write a help-centre article from this material:
Audience:
- Identify the one task the customer is trying to complete. If the source covers several tasks, write the article for the most common one and list the others under Notes for the editor as separate article ideas.
- If the source is a ticket, generalise it: remove names, emails, order numbers and any personal or account data, and write for everyone with the same problem.
- Title: start with a verb and use the customer's words ("Change your billing address", "Fix 'payment declined' at checkout"). Avoid internal feature names unless customers use them.
- Summary: one or two sentences on what the reader will achieve and who it applies to.
- Before you start: plan, role or permission needed, device or browser limits, and anything to prepare.
- Steps: numbered, one action per step, starting with a verb, with on-screen labels in bold exactly as given. Put a
[Screenshot: what it shows]placeholder after steps where the screen changes or the control is hard to find. State the expected result after the last step. - Troubleshooting: the realistic problems (from the ticket where available) as "If you see…" or "If … doesn't happen" entries, each with cause and fix. End with when and how to contact support and what to include.
- Related articles: two to four suggested titles, marked as suggestions.
- Do not invent UI labels, menu paths, limits or plan names. Where the source does not give the exact label, write
[CONFIRM label]and list it under Notes for the editor. - Use second person ("you"), present tense, and plain language suitable for the audience. If the audience is empty, write for a non-technical customer.
- Keep the article under about 400 words excluding troubleshooting, unless the task genuinely needs more steps.
- No marketing language and no internal reasoning about why the feature was built.
<Title>
Summary paragraph.
Before you start
Bullets.
Steps
Numbered, with screenshot placeholders. Final line: what you should see when it worked.
Troubleshooting
Bold "If…" lines, each followed by cause and fix.
Related articles
Bullets.
Notes for the editor
Bullets: every [CONFIRM] item, removed personal data, and other article ideas.
1 required value still a placeholder; the assistant will ask for it.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Business and strategy
- category
- Customer support
- level
- Beginner
- made for
- Customer support, Technical writer, Product manager
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-02
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install write-help-center-article --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-help-center-article -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-business@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Customer supportAnalyse support tickets
Finds the top contact drivers in a ticket export and ranks deflection opportunities by volume and effort, with root cause and owner. Use for a monthly or quarterly support review.
analyze-support-ticketsBuild support macros
Builds reusable support macros from real ticket samples, with personalisation slots, internal actions and rules for when not to use each. Use to speed up replies without sounding canned.
build-support-macrosSupport tone rules
Standing rules for every customer support reply - acknowledge first, plain words, no blame, honest limits, and a specific next step with a timeline.
support-tone-rulesAnswer donor service queries
Writes replies for a charity's supporter care team - receipts, changing or cancelling a regular gift, contact and data preferences, complaints about fundraisers - warm, accurate and quick to act on.
answer-donor-service-queriesAnswer a product warranty claim
Decides and answers a warranty or faulty-goods claim as a retailer or maker - evidence to request, repair, replace or refund under your terms and the consumer rules to check, and the reply.
answer-product-warranty-claimBrief drivers on doorstep service
Writes a one-page doorstep service brief for delivery drivers covering greeting, proof photos, safe places, refused or damaged goods, age-checked items, upset customers and when to call base.
brief-drivers-on-doorstep-service