skills.rest
FavioVazquez
FavioVazquezCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/FavioVazquez/learnship --skill clarify-faviovazquez
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Design & Creative Skills→
dhruvil7797dhruvil7797

clarify

Rewrite unclear UX copy, error messages, labels, and instructions across interfaces.

Community
Intermediate
Ender-Wiggin2019Ender-Wiggin2019
72

clarify

Refine unclear UX copy, error messages, and labels for clarity.

Community
Intermediate
YouneslahlaliYouneslahlali

clarify

Analyzes and rewrites unclear UX copy across error messages, labels, and buttons.

Community
Intermediate
guillermoscriptguillermoscript
21

clarify

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

Community
Intermediate