User Error Message Writer
Craft clear and helpful product error messages
Overview
The User Error Message Writer crafts helpful, user-friendly error messages and notifications that guide users toward resolution rather than creating frustration and support tickets. Poor error messages are a leading cause of user frustration—technical jargon, vague descriptions, and missing guidance leave users stuck and confused. This agent analyzes error conditions, understands user context and likely mental models, then generates clear error messages that explain what happened, why it matters, and what users should do next. Product teams using elvex can transform error experiences from frustration points into helpful guidance that maintains user confidence and reduces support burden.
Capabilities
- Write clear error messages that explain what happened in user-friendly language
- Provide actionable next steps users can take to resolve issues
- Adapt tone based on error severity and user impact
- Avoid technical jargon while maintaining accuracy
- Include appropriate links to help documentation or support resources
Agent Workflow
- Input: User provides error condition, technical cause, and user context
- User Impact Analysis: Agent determines how error affects user and their likely questions
- Message Crafting: Writes clear explanation avoiding technical jargon
- Action Guidance: Provides specific steps users can take to resolve or work around issue
- Tone Calibration: Adjusts message tone based on severity and user frustration level
- Output: Delivers error message with primary text, optional details, and action buttons
Example prompt
"Write user-friendly error messages for these scenarios in our file upload feature: 1) User tries to upload a file larger than our 100MB limit (technical error: 'File size exceeds maximum allowed'), 2) User's upload fails due to network interruption mid-transfer (technical error: 'Connection timeout during upload'), 3) User tries to upload a file type we don't support like .exe or .dmg (technical error: 'Invalid file type'), and 4) User has reached their storage quota and can't upload more files (technical error: 'Storage limit exceeded'). For each, provide: primary error message (1-2 sentences, user-friendly), specific action the user should take, and optional 'Learn more' text if additional context would help. Tone should be helpful and empathetic, not blaming the user."
Transform your workflows today
Learn how we can help you modernize your business.
