clarify

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

1|1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/SwimmingLiu/easy-skills --skill clarify-swimmingliu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/SwimmingLiu/easy-skills/tree/main/skills/frontend/clarify
Command: npx skills add https://github.com/SwimmingLiu/easy-skills --skill clarify-swimmingliu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses confusing, ambiguous, or poorly written user interface text, making software and products significantly easier for users to understand and navigate.

Core Features & Use Cases

  • UX Copy Improvement: Refines unclear UX copy, error messages, microcopy, labels, and instructions.
  • Clarity Assessment: Identifies jargon, ambiguity, passive voice, and tone mismatches.
  • Use Case: An e-commerce site has confusing error messages during checkout. This Skill can rewrite them to clearly explain the problem and guide the user on how to fix it, reducing cart abandonment.

Quick Start

Use the clarify skill to improve the error message "Invalid input" on the login form.

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 for better user interface clarity?

To improve UX copy for clarity, you refine user interface text like labels and instructions. This skill analyzes existing copy based on audience and context, applying principles of specificity, conciseness, and active voice to enhance overall usability.

How can I rewrite confusing error messages to reduce user friction?

Rewriting confusing error messages requires identifying jargon and ambiguity in the text. The skill refines error messages into active voice, clearly explaining the problem and guiding the user on how to fix the input to prevent cart abandonment.

What is microcopy and how does it affect empty states and form labels?

Microcopy is the small text that guides users, including form labels and empty states. Refining microcopy ensures the text matches the desired action and tone, removing ambiguity and making software significantly easier to navigate.

Does this UX writing approach work for e-commerce checkout flows?

Yes, this UX writing approach works for e-commerce checkout flows. By rewriting confusing error messages during checkout to clearly explain problems, it guides users on how to fix inputs, directly reducing cart abandonment.

Why should I use active voice when refining user interface text?

Using active voice when refining user interface text provides specificity and conciseness. It directly addresses the audience, clearly instructing them on the desired action, which removes ambiguity and improves product usability.