clarify

Rewrite unclear UI microcopy into concise, actionable, localization-ready text.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear or confusing user-facing interface text that causes user errors, friction, and support requests by making copy specific, actionable, and appropriately toned for the moment.

Core Features & Use Cases

  • Audit & diagnosis: Identify jargon, ambiguity, passive voice, missing context, length issues, and tone mismatches in error messages, labels, and microcopy.
  • Targeted rewrites: Produce concise, actionable alternatives for error messages, form labels, CTAs, tooltips, empty states, confirmations, and loading text with rationale and examples.
  • Use case: Turn a vague "Invalid input" error into a clear, user-guiding message that states what went wrong, why, and how to fix it while matching the user's technical level and emotional state.

Quick Start

Ask the clarify skill to improve the error message "Invalid input" for non-technical users and provide a short, actionable alternative with a brief rationale.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I write better UX microcopy for error messages and form labels?

To write better UX microcopy, you need to identify jargon and ambiguity, then rewrite text into concise, actionable alternatives. This involves stating what went wrong, why it happened, and how to fix it while matching the user's technical level and emotional state.

What is the best way to rewrite vague interface text like Invalid input for non-technical users?

The best way to rewrite vague interface text is to replace it with specific, actionable guidance. Transform an invalid input error by clearly stating the problem, the cause, and the exact steps required to resolve it, ensuring the tone matches the user's mental state.

How do I make UI copy clear and actionable for localization?

To make UI copy clear and actionable for localization, audit text for idioms, passive voice, and missing context. Produce concise, culturally neutral alternatives for tooltips and empty states that guide users effectively without relying on region-specific phrasing.

Can I audit my existing product interface text for tone and clarity issues?

Yes, you can audit existing product interface text for tone and clarity. The process diagnoses jargon, ambiguity, length issues, and tone mismatches across web and mobile interfaces, providing targeted rewrites with rationale for each identified problem.

What context do I need to provide to improve mobile app empty states and loading text?

To improve mobile app empty states and loading text, you must provide context about the audience's technical level, the user's mental state during that interaction, and frontend-design context. This ensures the resulting copy is appropriately toned and actionable.

Why does unclear microcopy increase user friction and support requests?

Unclear microcopy increases user friction and support requests because it causes confusion and errors. When interface text lacks specificity, actionability, and appropriate tone, users cannot understand what went wrong or how to proceed, leading to higher support volume.