clarify

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses confusing, unclear, or poorly written interface text (UX copy, error messages, microcopy, labels, instructions) to make products more understandable and user-friendly.

Core Features & Use Cases

  • Clarity Assessment: Identifies jargon, ambiguity, passive voice, length issues, assumptions, and missing context in existing copy.
  • Contextual Analysis: Considers audience, user's mental state, desired action, and constraints.
  • Copy Improvement: Refines error messages, form labels, button text, help text, empty states, success messages, loading states, confirmation dialogs, and navigation labels.
  • Use Case: A user encounters an error message "Operation failed. Code: 500." This Skill can transform it into a user-friendly message like "We couldn't save your changes due to a temporary server issue. Please try again in a few minutes."

Quick Start

Use the clarify skill to improve the error message "Invalid input" for a username 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?

To improve unclear UX copy, analyze existing text for jargon, ambiguity, and passive voice. This refines error messages, labels, and microcopy into clear, actionable communication that enhances user understanding.

What is the best way to rewrite confusing microcopy for user interfaces?

The best way to rewrite confusing microcopy is by evaluating audience, user state, and desired action. This process transforms technical or vague text into helpful, active, and human instructions for better usability.

Can I use this to fix technical error messages like operation failed code 500?

Yes, you can fix technical error messages like operation failed code 500. It analyzes missing context and transforms it into a user-friendly message, such as explaining a temporary server issue and prompting a retry.

How do I refine form labels and button text for better usability?

To refine form labels and button text for better usability, assess text length and underlying assumptions. This adjusts navigation labels and instructions to be clear, concise, and aligned with the user's mental state.

When do I need UX writing analysis for empty states and loading states?

You need UX writing analysis for empty states and loading states when interface text contains jargon or lacks context. It refines these UI elements to ensure communication remains clear, active, and helpful during waiting periods.