skills.rest
xlsama
xlsamaCOMMUNITY
Explore all skills by this author →
Website𝕏@xlsama_GitHub

clarify

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

Updated Jun 26, 2022
Search Tags:#clarity#microcopy#copywriting#ux writing#user interface#error messages
One-click install
npx skills add https://github.com/xlsama/use --skill clarify-xlsama
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/xlsama/use/tree/main/config/agents/skills/clarify
Command: npx skills add https://github.com/xlsama/use --skill clarify-xlsama

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses confusing, ambiguous, or poorly written text within user interfaces, making products more intuitive and user-friendly.

Core Features & Use Cases

  • Identify Clarity Issues: Detects jargon, ambiguity, passive voice, excessive length, and missing context in UI copy.
  • Improve Error Messages: Rewrites error messages to be clear, actionable, and empathetic.
  • Refine Labels & Instructions: Ensures form labels and instructions are specific and easy to understand.
  • Use Case: A user encounters an error message like "Operation failed." This Skill can transform it into "Could not save your changes. Please check your internet connection and try again."

Quick Start

Improve the clarity of the error message "Invalid input" for a username field.

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?▼

To improve unclear UX copy, refine error messages and microcopy by analyzing text for jargon, ambiguity, and passive voice. This ensures your user interface text is clear, actionable, and empathetic for the audience.

What is the best way to rewrite confusing error messages for better user experience?▼

The best way to rewrite confusing error messages is to resolve missing context and tone mismatch. Refine the text based on user state and constraints, transforming vague failures into specific, actionable guidance.

How do I fix ambiguous form labels and instructions for better usability?▼

Fix ambiguous form labels and instructions by evaluating them for excessive length and unstated assumptions. Refine the microcopy to be specific, ensuring your user interface understandability matches the audience's needs.

Can I use UX writing techniques for empty states and confirmation dialogs?▼

Yes, you can apply UX writing techniques to empty states, confirmation dialogs, loading states, and navigation. Analyze the copy for clarity issues like jargon or tone mismatch to enhance overall usability.

How do I identify tone mismatch and jargon in my UI microcopy?▼

Identify tone mismatch and jargon in UI microcopy by analyzing the text against the expected audience and user state. This process detects ambiguity, passive voice, and missing context to ensure clear communication.

Related Skills

Explore More Design & Creative Skills→
mklozmkloz

clarify

Analyze UI copy and generate improvement plans for clarity.

Community
Advanced
tomada1114tomada1114
4

designing-wireframes

Design ASCII wireframes and UX flows from detailed requirements.

Community
Basic
SwimmingLiuSwimmingLiu
1

clarify

Rewrite unclear UI text into concise, active-voice copy.

Community
Basic
madebynoammadebynoam

dcode:improve-copy

Apply UX writing frameworks to improve UI microcopy.

Community
Intermediate