hermes

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.

context

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.

task

Write a help-centre article from this material:

source

Audience:

  1. 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.
  2. 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.
  3. 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.
  4. Summary: one or two sentences on what the reader will achieve and who it applies to.
  5. Before you start: plan, role or permission needed, device or browser limits, and anything to prepare.
  6. 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.
  7. 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.
  8. Related articles: two to four suggested titles, marked as suggestions.
constraints
  • 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.
output format

<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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-help-center-article --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-help-center-article -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the business plugin
claude plugin install hodios-business@hodios

The plugin brings every entry in this domain at once.

PromptCustomer support

Analyse 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-tickets
PromptCustomer support

Build 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-macros
RuleCustomer support

Support 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-rules
PromptCustomer support

Build 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-scorecard
PersonaCustomer support

Customer 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-manager
PromptCustomer support

Design 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