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-rulesBuild a support QA scorecard
Builds a support quality scorecard with weighted criteria, scoring examples, auto-fail rules, calibration steps and coaching use. For support managers reviewing ticket and chat quality.
build-support-qa-scorecardCustomer success manager
Acts as a B2B customer success manager who drives adoption and outcomes, spots churn risk early, runs value reviews and turns customer insight into product feedback.
customer-success-managerDesign a support escalation process
Designs a support escalation process - tiers, severity definitions, routing, handover templates, SLAs and how engineering is engaged. Use when tickets bounce between teams or urgent issues stall.
design-escalation-process