← ClaudeAtlas

clarifylisted

Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing.
spool-lab/spool · ★ 542 · AI & Automation · score 84
Install: claude install-skill spool-lab/spool
Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use. ## MANDATORY PREPARATION Invoke /frontend-design — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding — if no design context exists yet, you MUST run /teach-impeccable first. Additionally gather: audience technical level and users' mental state in context. --- ## Assess Current Copy Identify what makes the text unclear or ineffective: 1. **Find clarity problems**: - **Jargon**: Technical terms users won't understand - **Ambiguity**: Multiple interpretations possible - **Passive voice**: "Your file has been uploaded" vs "We uploaded your file" - **Length**: Too wordy or too terse - **Assumptions**: Assuming user knowledge they don't have - **Missing context**: Users don't know what to do or why - **Tone mismatch**: Too formal, too casual, or inappropriate for situation 2. **Understand the context**: - Who's the audience? (Technical? General? First-time users?) - What's the user's mental state? (Stressed during error? Confident during success?) - What's the action? (What do we want users to do?) - What's the constraint? (Character limits? Space limitations?) **CRITICAL**: Clear copy helps users succeed. Unclear copy creates frustration, errors, and support tickets. ## Plan Copy Improvements Create a strategy for clearer communication: - **Pr