clarify

Identify and rewrite unclear UX copy in product interfaces.

Updated Feb 27, 2025
One-click install
npx skills add https://github.com/tuanemuy/dotfiles --skill clarify-tuanemuy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/tuanemuy/dotfiles/tree/main/config/claude/skills/clarify
Command: npx skills add https://github.com/tuanemuy/dotfiles --skill clarify-tuanemuy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams identify unclear UX copy (labels, error messages, microcopy) and rewrite it to be clearer, more helpful, and consistent across the product.

Core Features & Use Cases

  • Identify and audit unclear copy across screens and components to flag ambiguous terms and improve consistency.
  • Propose clearer alternatives for labels, error messages, tooltips, and input prompts, with rationale and examples.
  • Apply a structured workflow to align stakeholders and maintain a human-centric tone across platforms.

Quick Start

Provide the specific UI copy you want clarified, and the AI will generate clearer, user-friendly alternatives.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I improve unclear UX copy in my product interface?

To improve unclear UX copy, provide specific UI text like labels or error messages to generate clearer, user-friendly alternatives. The skill audits ambiguous terms and proposes actionable rewrites with rationale to increase usability across web and mobile components.

What is the best way to rewrite error messages for better usability?

The best way to rewrite error messages for usability is to apply structured prompts that enforce a human-centric tone. This process identifies unclear text and proposes consistent, helpful alternatives with examples to guide users effectively.

Can I use this to audit microcopy consistency across web and mobile components?

Yes, you can audit microcopy consistency across web and mobile components. The skill identifies and flags ambiguous terms across screens, proposing clearer alternatives for tooltips and input prompts to maintain a consistent, human-friendly language.

How do I align stakeholders on UI text revisions?

You align stakeholders on UI text revisions by applying a structured workflow that provides rationale and examples for proposed copy changes. This ensures teams maintain a human-centric tone and consistent language across the product.

Does this work for both input labels and tooltips?

Yes, this works for both input labels and tooltips. It identifies unclear copy across these component types and proposes clearer, actionable alternatives to ensure the language used is helpful and consistent for users.