clarify

Rewrite unclear UX copy into plain-language interface text.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/luyangliuable/claude-setup --skill clarify-luyangliuable
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/luyangliuable/claude-setup/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/luyangliuable/claude-setup --skill clarify-luyangliuable

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps improve unclear interface text so users can understand errors, labels, instructions, buttons, and messages without confusion. It is useful when copy feels too technical, vague, wordy, inconsistent, or mismatched to the user's context.

Core Features & Use Cases

  • Error Message Rewrite: Replaces vague or blamey errors with plain-language messages that explain what went wrong and how to fix it.
  • UI Copy Improvement: Refines form labels, helper text, CTAs, empty states, loading text, confirmations, and navigation labels for clarity and consistency.
  • UX Tone Calibration: Adjusts wording to fit the user's emotional state and the product's voice, especially in stressful or high-friction moments.
  • Use Case: A product team can use this Skill to rewrite a confusing permission error, improve a signup form label, and make a destructive action confirmation more specific.

Quick Start

Ask the clarify skill to rewrite this UI message so it is clearer, more concise, and more helpful for users.

Frequently Asked Questions about clarify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rewrite vague error messages into clear UX copy?

To rewrite vague error messages into clear UX copy, replace technical or blamey language with plain text that explains the failure and provides actionable next steps. This ensures users understand the issue and how to resolve it immediately.

What is UX writing and when do I need to improve interface labels?

UX writing is the practice of crafting clear interface text for labels, buttons, and instructions. You need to improve microcopy when it feels too technical, vague, wordy, or inconsistent with the user's context and emotional state.

How do I make form labels and empty states easier to understand?

To make form labels and empty states easier to understand, apply plain-language rewriting that preserves the original intent while adding necessary context. This refines helper text and navigation labels for clarity and consistent terminology.

What is the best way to calibrate tone for destructive action confirmations?

The best way to calibrate tone for destructive action confirmations is to adjust the wording to fit the user's emotional state and the product voice. Make high-friction moments more specific and clear to reduce user anxiety.

Can I use plain-language rewriting to improve loading and success messages?

Yes, you can use plain-language rewriting to improve loading text, success messages, and tooltips. This maintains consistent terminology across the interface and suggests next actions to guide the user effectively.