clarify

Identify and rewrite unclear UI copy for web and mobile interfaces.

Updated Nov 4, 2025
One-click install
npx skills add https://github.com/jatwell93/pharmacy-heatmap --skill clarify-jatwell93
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/jatwell93/pharmacy-heatmap/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/jatwell93/pharmacy-heatmap --skill clarify-jatwell93

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interfaces often present unclear or ambiguous copy that confuses users, slows tasks, and increases support needs. This Skill helps identify unclear text and generate clearer, more usable alternatives.

Core Features & Use Cases

  • Copy clarity assessment: detects jargon, ambiguity, passive voice, and vague labels across error messages, prompts, placeholders, tooltips, and instructions.
  • Clear rewrite proposals: provides concise, actionable alternatives aligned to user goals and product tone.
  • Use Case example: onboarding a feature with confusing labels, generate revised copy and a brief rationale.

Quick Start

Provide the unclear UI text and your target audience, and I will return a clearer, more actionable rewrite.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite unclear UX copy to improve usability?

To rewrite unclear UX copy, provide the existing UI text and target audience to generate clearer, actionable alternatives. This process detects jargon and vague labels, delivering concise rewrites with rationale to boost user understanding and reduce errors.

What makes interface text confusing for users?

Interface text becomes confusing when it contains jargon, ambiguity, passive voice, or vague labels. These issues slow user tasks and increase support needs, which is why a structured clarity assessment is needed to identify and correct unclear copy.

Can I use this to fix error messages and tooltips for mobile interfaces?

Yes, you can use this to fix error messages and tooltips for mobile interfaces. The clarity process applies across labels, prompts, placeholders, and in-context instructions for both web and mobile platforms to ensure user understanding.

How do I assess copy consistency across my product?

To assess copy consistency, evaluate interface text like labels, prompts, and instructions against a structured clarity framework. This identifies ambiguous terms and passive voice, providing actionable rewrite proposals aligned with your product tone.

Why does my UI copy need a rationale for tone guidance?

UI copy needs a rationale for tone guidance to ensure rewrite proposals align with user goals and product voice. Providing a brief rationale explains why the clearer alternative improves user understanding and reduces task errors.