clarify

Analyze UX copy for jargon, ambiguity, and passive voice.

59|5|Updated Mar 8, 2026

Search Tags:#clarity #microcopy #copywriting #ux writing #user interface #error messages

Ready to run

npx skills add https://github.com/FavioVazquez/learnship --skill clarify-faviovazquez

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/FavioVazquez/learnship/tree/main/.windsurf/skills/impeccable/clarify
Command: npx skills add https://github.com/FavioVazquez/learnship --skill clarify-faviovazquez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the frustration and errors caused by unclear, confusing, or poorly written interface text, making products more intuitive and user-friendly.

Core Features & Use Cases

Clarity Assessment: Identifies jargon, ambiguity, passive voice, and other clarity issues in UX copy.
Contextual Improvement: Refines error messages, form labels, button text, and more, considering audience and user state.
Use Case: Improve the confusing error message displayed when a user fails to upload a file, making it clear what went wrong and how to fix it.

Quick Start

Use the clarify skill to improve the error message for file uploads.

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, you analyze text for jargon, ambiguity, passive voice, and tone mismatch, then refine error messages, labels, and instructions to enhance user understanding and usability.

What is the best way to rewrite confusing error messages for file uploads?▼

The best way to rewrite confusing error messages is to focus on specificity, conciseness, active voice, and helpfulness so users clearly understand what went wrong and how to fix the issue.

How do I fix ambiguous microcopy and form labels for better user comprehension?▼

You fix ambiguous microcopy and form labels by assessing the text for clarity issues and refining it contextually to ensure the instructions match the audience and user state.

Can I use this approach to refine button text and empty states across user interfaces?▼

Yes, you can refine button text and empty states by analyzing the existing copy for clarity issues and applying principles of specificity and active voice to improve overall product intuitiveness.

Why does passive voice make my interface instructions confusing for users?▼

Passive voice makes interface instructions confusing because it creates ambiguity and obscures the actor, so refining instructions into active voice directly enhances user understanding and usability.

What are the limitations of using automated clarity assessment for UX writing?▼

Automated clarity assessment for UX writing focuses strictly on analyzing jargon, ambiguity, passive voice, and tone, requiring a defined context to accurately refine text and improve user comprehension.