clarify

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

4|Updated Oct 28, 2019
One-click install
npx skills add https://github.com/cfbender/dotfiles --skill clarify-cfbender
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/cfbender/dotfiles/tree/main/dot_agents/skills/clarify
Command: npx skills add https://github.com/cfbender/dotfiles --skill clarify-cfbender

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses confusing, unclear, or poorly written interface text, making products more understandable and user-friendly.

Core Features & Use Cases

  • Clarity Assessment: Identifies jargon, ambiguity, passive voice, and other clarity issues.
  • Contextual Improvement: Tailors copy based on audience, user state, and action.
  • Systematic Refinement: Offers specific improvements for error messages, labels, CTAs, and more.
  • Use Case: Improving the error message for a failed login attempt to clearly explain the issue and guide the user on how to resolve it.

Quick Start

Improve the clarity of the error message "Invalid input" for the email 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 for better user understanding?

To improve unclear UX copy, analyze text for jargon, ambiguity, and passive voice, then systematically refine error messages, labels, and instructions to enhance user understanding and product usability.

What is the best way to rewrite microcopy for form labels and button text?

Rewriting microcopy for form labels and button text requires applying principles of specificity, conciseness, active voice, and human-centered communication to ensure instructions are clear and actionable for the user.

How do I fix a confusing login error message to guide users on resolving the issue?

Fixing a confusing login error message requires assessing the text for clarity issues and context, then refining it to specifically explain the problem and guide the user on how to resolve the failed attempt.

Can I tailor UX writing based on user state and action context?

You can tailor UX writing by analyzing the specific audience, user state, and action context, allowing you to systematically refine interface elements like CTAs and error messages for maximum clarity.

Why does passive voice reduce clarity in user interface content design?

Passive voice reduces clarity in user interface content design by creating ambiguity around the action and subject, whereas active voice ensures specificity and human-centered communication.