clarify

Rewrite unclear interface copy for labels, errors, placeholders, and calls to action.

2|1|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/duggal1/Sapphire-cli --skill clarify-duggal1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/duggal1/Sapphire-cli/tree/main/internal/skills/bundled/clarify
Command: npx skills add https://github.com/duggal1/Sapphire-cli --skill clarify-duggal1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unclear UX copy, error messages, microcopy, labels, and instructions hinder user understanding and task completion, leading to confusion and support overhead.

Core Features & Use Cases

  • Context-Driven clarity: Align copy with user audience, mental state, and task goals.
  • Structured copy improvements: Plan the primary message, action, tone, and constraints; update error messages, labels, placeholders, and calls to action.
  • Iterative validation: Apply clarity principles (specificity, conciseness, activeness) and verify comprehension and tone across the product.

Quick Start

Provide a rewritten, clearer version of the target interface text.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I write clearer UX copy for interface labels and error messages?

Rewriting UX copy involves analyzing the audience mental state and task goals to provide concrete, improved versions of interface text. It aligns labels and calls to action with user expectations to reduce support overhead.

What is microcopy and how does it affect usability?

Microcopy consists of the short instructions and error messages within a user interface. Refining this text ensures it aligns with user mental states and task goals, preventing user frustration and lowering support overhead.

Can I improve UI copy across different components and localization constraints?

Improving UI copy across components requires planning the primary message, action, tone, and constraints for each element. This structured approach validates comprehension while respecting localization requirements for diverse audiences.

What is the best way to rewrite confusing error messages for better user experience?

Rewriting error messages requires structuring the primary message, action, tone, and constraints for the target audience. This method replaces confusing text with clear, actionable instructions to improve user task completion.

Why does unclear interface text lead to higher support overhead?

Poorly written UX copy causes user confusion and prevents successful task completion. Improving labels and microcopy aligns the interface with user mental states, directly reducing the support volume caused by unclear text.