clarify

Rewrite unclear UX copy across web and mobile interfaces.

Updated Nov 13, 2023
One-click install
npx skills add https://github.com/Bloodrey41/dotfiles --skill clarify-bloodrey41
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/Bloodrey41/dotfiles/tree/main/.claude/skills/clarify
Command: npx skills add https://github.com/Bloodrey41/dotfiles --skill clarify-bloodrey41

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing.

Core Features & Use Cases

  • Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.
  • Plan Copy Improvements: Create a strategy for clearer communication: primary message, action needed, tone, constraints.
  • Improve Copy Systematically: Cover Error Messages, Form Labels & Instructions, Button & CTA Text, Help Text & Tooltips, Empty States, Success Messages, Loading States, Confirmation Dialogs, Navigation & Wayfinding; plus UX writing principles.
  • Example: Provide a simple real-world scenario where you rewrite copy to guide user actions.

Quick Start

Review the Context Gathering Protocol under /frontend-design, assess audience and user state, and propose clear copy improvements.

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 and error messages for better clarity?▼

To improve error messages, you rewrite them to be actionable and consistent with your product tone. Aligning the copy with audience understanding ensures users know exactly what action is needed for error recovery.

What is the best way to write clear form labels and button text for web interfaces?▼

Writing clear form labels and button text requires planning a copy strategy that defines the primary message and action needed. Applying UX writing principles ensures your CTAs and instructions are easily understood across web and mobile platforms.

Can I improve onboarding instructions and empty states for mobile apps using UX writing guidelines?▼

Yes, you can improve onboarding instructions and empty states by gathering context about your audience and user state. Rewriting these components with clear copy guidelines makes mobile interfaces easier to navigate and understand.

Does UX writing for UI copy require context gathering and audience understanding?▼

Yes, effective UX writing for UI copy requires context gathering and audience understanding to align language with the product tone. This process identifies user state and constraints to ensure microcopy remains actionable and consistent.

How do I fix confusing microcopy and help text that users ignore?▼

To fix confusing microcopy and help text, evaluate the user state and systematically rewrite the instructions to guide user actions. Replacing vague tooltips with clear, actionable language improves overall interface comprehension.

When should I not use automated UX copy rewriting for interface text?▼

You should avoid automated UX copy rewriting when your interface requires highly specialized domain terminology or strict legal constraints that demand manual review. Automated tools lack the deep product context needed for nuanced tone alignment.