Writing User Guide Skill

When to Use This Skill

Load this skill whenever you are writing or editing content meant for the people who use an application — not the people who build or support it internally:

• User guides, user manuals, help center articles
• How-to / step-by-step instructions for end users
• In-app help text, tooltips, or onboarding copy
• Customer-facing release notes describing a new feature

This skill must always trigger whenever the user asks to write, create, draft, or update a "guide," "documentation," "manual," "help doc," or similar end-user-facing document — even if the request is a short, generic ask like "write a guide for this feature" or "create documentation for X" that doesn't spell out these rules.

The Reader

Write for the actual end-user of the application: someone who uses the product to get their work done and has no knowledge of how it's built. They don't know what a database, API, queue, cache, feature flag, or backend service is, and they don't need to. Before writing a line, picture that reader and ask "would this sentence mean anything to them?" — if not, cut or rephrase it.