clarify

Rewrites unclear UX copy, error messages, labels, and microcopy for better comprehension.

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

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 missing context in your product copy and rewrites it so users understand immediately. ## Core Features & Use Cases - Copy Auditing: Detects jargon, ambiguity, tone mismatches, and overly long or terse text across your interface. - Systematic Rewriting: Improves error messages, form labels, button text, tooltips, empty states, success messages, loading states, confirmation dialogs, and navigation labels using proven before/after patterns. - Clarity Principles: Enforces specific, concise, active, human, helpful, and consistent writing with explicit rules on what to never do. - Use Case: Your settings page shows "Error 403: Forbidden" and a generic "Submit" button. Run this Skill to get "You don't have permission to view this page. Contact your admin for access." and "Save changes" instead. ## Quick Start Ask the assistant to review and clarify the copy in a specific feature or component, for example: clarify 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. For example, replace "Invalid input" with "Email addresses need an @ symbol. Try: [email protected]" and link to help when applicable.

How to write better button and CTA text?

Describe the specific action using active voice with a verb plus noun, such as "Create account" or "Save changes" instead of "Submit" or "OK". Match the user's mental model and be specific about what happens next.

What makes UX copy unclear or confusing?

Common problems include jargon users don't understand, ambiguous phrasing, passive voice, excessive length, assumed knowledge, and missing context about what to do next. Tone mismatches with the user's emotional state also reduce clarity.

Should I use placeholders as form field labels?

No, placeholders disappear when users type, leaving them without context. Use clear, specific labels above the field and show format expectations through placeholder examples or helper text instead.

When should confirmation dialogs be used?

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.