clarify

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

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/Moliboy5000/.claude --skill clarify-moliboy5000
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/Moliboy5000/.claude/tree/main/plugins/cache/impeccable/impeccable/1.3.0/source/skills/clarify
Command: npx skills add https://github.com/Moliboy5000/.claude --skill clarify-moliboy5000

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses confusing, unclear, or poorly written text within user interfaces, ensuring that users can easily understand and interact with the product.

Core Features & Use Cases

  • Identify Clarity Problems: Detects jargon, ambiguity, passive voice, excessive length, and missing context in UX copy.
  • Improve Specific Copy Types: Offers targeted improvements for error messages, form labels, button text, help text, empty states, success messages, loading states, confirmation dialogs, and navigation.
  • Use Case: A user encounters an error message that simply says "Operation failed." This Skill can transform it into a helpful message like "Failed to save your changes. Please check your internet connection and try again."

Quick Start

Use the clarify skill to improve the error message 'Invalid input'.

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 UX copy, you analyze text for jargon, ambiguity, passive voice, and excessive length, then refine it based on audience and context to enhance interface clarity. This systematic process transforms unhelpful messages into actionable instructions.

What makes a good error message for user interfaces?

A good error message explains the problem clearly and provides a actionable next step. Instead of vague text like "Operation failed," it specifies the issue and instructs the user to check their connection and retry, ensuring usability.

How do I fix ambiguous microcopy and form labels?

Fixing ambiguous microcopy involves analyzing the text for missing context and passive voice, then refining the wording to match the user's task. This ensures labels, buttons, and instructions are direct and easy to understand.

When should I revise UX writing for empty states and loading states?

You should revise UX writing for empty and loading states when the text lacks context or fails to guide the user. Refining these messages ensures users understand the interface status and know what action to take next.

Can I use this approach to simplify technical jargon in confirmation dialogs?

Yes, you can systematically identify and simplify technical jargon in confirmation dialogs. By analyzing the text for clarity problems and refining it based on the intended audience, you ensure the dialogue is clear and effective for all users.