By Johnny Chan · UI/UX Designer, Hong Kong
UX Writing for AI Assistants: Prompts, Replies, and Guardrails
How to write system prompts, suggested starters, and in-thread copy so AI features feel helpful — not creepy, vague, or overly corporate.

AI assistants live or die on words. Visual polish cannot save confusing suggested prompts or robotic replies. I treat assistant copy like any critical UI: short, testable, and aligned with what the model can actually do.
Suggested prompts should be real tasks
Replace “Ask me anything” with three concrete jobs your users already want: “Track my repair booking,” “Compare plans,” “Summarize this page.” Prompts teach capability better than feature lists.
Tone: helpful, not performative
- Avoid fake enthusiasm and over-apologizing.
- Use plain language; skip jargon unless the audience is technical.
- Match brand voice — warm for consumer, crisp for B2B.
Guardrails users can see
Microcopy for blocked requests should explain why (“I can't change your password here — use Settings”) instead of a generic error. Transparency builds more trust than pretending the AI can do everything.
Test copy with five users before launch — AI wording ages fast and bad phrases scale instantly.
Iterate from conversation logs
Review where users rephrase the same question three times. That is a signal your starter prompts or first reply missed intent. UX writers and designers should pair on those loops weekly in early releases.
Let's work together
Open to UI/UX projects, collaborations, and product design support in Hong Kong and remotely.
Let's Connect