clarify

Identify and improve unclear UX copy across web and mobile interfaces.

57.3k|3.5k|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/pbakaus/impeccable --skill clarify-pbakaus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/pbakaus/impeccable/tree/main/source/skills/clarify
Command: npx skills add https://github.com/pbakaus/impeccable --skill clarify-pbakaus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.

Core Features & Use Cases

  • Assess Current Copy: Identify clarity problems and understand context to guide improvements.
  • Plan Copy Improvements: Define primary message, next actions, tone, and constraints.
  • Improve Copy Systematically: Refine error messages, form labels, buttons, help text, empty states, success messages, loading states, confirmation dialogs, and navigation.
  • Use Case: Example of rewriting error messages or labels to reduce support tickets and improve task success.

Quick Start

Provide the current UI copy you want clarified, and I will propose clearer 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 web or mobile app?

To improve unclear UX copy, the Skill assesses current interface text for clarity problems, plans primary messages and tone, and systematically refines error messages, labels, and tooltips to reduce ambiguity.

What is the best way to rewrite confusing error messages and UI labels?

The best way to rewrite confusing error messages and UI labels is through a structured workflow that defines the primary message and constraints, ensuring clarity and consistency to reduce support tickets and improve task success.

Can I use this to fix onboarding copy and tooltips for better usability?

Yes, you can fix onboarding copy and tooltips for better usability by applying the structured assessment and refinement workflow to ensure text clarity, consistency, and reduced ambiguity across web and mobile interfaces.

Does this approach work for refining empty states and loading messages?

Yes, this approach works for refining empty states, loading states, and success messages by systematically assessing current copy, defining the primary message, and improving text clarity to guide user actions effectively.

When should I systematically assess and rewrite microcopy?

You should systematically assess and rewrite microcopy when interface text causes user confusion, increases support tickets, or reduces task success, requiring a disciplined approach to clarify labels, placeholders, and navigation.