clarify

Analyze and refine unclear UX copy, error messages, and labels.

21|16|Updated Jul 12, 2023
One-click install
npx skills add https://github.com/guillermoscript/lms-front --skill clarify-guillermoscript
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/guillermoscript/lms-front/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/guillermoscript/lms-front --skill clarify-guillermoscript

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses confusing, unclear, or poorly written text within user interfaces, making products more intuitive and easier to use.

Core Features & Use Cases

  • Identify Clarity Issues: Detects jargon, ambiguity, passive voice, excessive length, and lack of context in UI text.
  • Improve Specific Areas: Refines error messages, form labels, button text, help text, empty states, success messages, loading states, confirmation dialogs, and navigation labels.
  • Use Case: A user encounters an error message that simply says "Invalid input." This Skill can transform it into a helpful message like "Email addresses need an @ symbol. Try: [email protected]".

Quick Start

Use the clarify skill to improve the error message on the login screen.

Frequently Asked Questions about clarify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve unclear UX copy and error messages in my user interface?

Transforming unhelpful error messages requires adding context and actionable solutions. By applying UX writing principles like specificity and human tone, generic errors become guided prompts, such as changing "Invalid input" to "Email addresses need an @ symbol. Try: [email protected]".

What is the best way to rewrite confusing microcopy for better user understanding?

The best way to rewrite confusing microcopy is to evaluate the text for excessive length and lack of context, then refine it using active voice and a human tone. This ensures instructions, labels, and navigation text are concise and highly usable.

Can I use this approach to refine both form labels and empty states?

Yes, you can refine form labels, empty states, success messages, loading states, and confirmation dialogs. Analyzing each UI element for consistency and clarity ensures the entire user interface communicates effectively and helps users complete their tasks.

Why does passive voice reduce usability in user interface text?

Passive voice reduces usability in user interface text because it creates ambiguity around the required action, obscures responsibility, and increases cognitive load. Replacing passive constructs with active voice makes instructions direct, specific, and immediately understandable for the user.

How do I fix jargon in UX writing without losing technical accuracy?

To fix jargon in UX writing without losing technical accuracy, identify complex terms within your interface text and replace them with specific, human-centered language. This maintains the core meaning while ensuring the instructions remain accessible and easy to understand.