clarify

Rewrites unclear UX copy, error messages, labels, and instructions for interface comprehension.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/AkaraChen/proxy-up --skill clarify-akarachen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/AkaraChen/proxy-up/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/AkaraChen/proxy-up --skill clarify-akarachen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Confusing interface text causes user errors, frustration, and support tickets. This Skill identifies jargon, ambiguity, passive voice, and tone mismatches in UX copy and rewrites it so users understand immediately. ## Core Features & Use Cases - Copy Assessment: Diagnoses clarity problems including jargon, ambiguity, missing context, and tone mismatch based on audience and user mental state. - Systematic Rewriting: Improves error messages, form labels, button text, tooltips, empty states, success messages, loading states, confirmation dialogs, and navigation labels with before/after patterns. - Use Case: When a settings page shows "Error 403: Forbidden", use this Skill to rewrite it as "You don't have permission to view this page. Contact your admin for access." ## Quick Start Use the clarify skill to review and improve the error messages and form labels in my checkout flow.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I improve unclear error messages in my app?▼

Explain what went wrong in plain language, suggest how to fix it, and avoid blaming the user. Replace codes like "Error 403" with actionable text such as "You don't have permission to view this page. Contact your admin for access."

How to write better UX microcopy for forms and buttons?▼

Use specific labels instead of generic placeholders, show format expectations with examples, and write button text as verb plus noun like "Save changes" instead of "OK". Put instructions before the field and explain why information is requested.

What makes UX writing clear and effective?▼

Clear UX writing is specific, concise, active, human, helpful, and consistent. It avoids jargon, passive voice, vague statements, and humor in errors, and uses one consistent term for each concept throughout the product.

When should confirmation dialogs be used in interfaces?▼

Use confirmations only for risky or destructive actions, stating the specific action and its consequences, such as "Delete 'Project Alpha'? This can't be undone." Overusing confirmations trains users to ignore them.

What are common UX copy mistakes to avoid?▼

Common mistakes include jargon without explanation, blaming users, vague messages like "Something went wrong", overly long explanations, inconsistent terminology, and relying on placeholders as the only field labels.