clarify

Rewrite unclear interface text into concise, active, and helpful copy.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/robertsthomas/hellobrand --skill clarify-robertsthomas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/robertsthomas/hellobrand/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/robertsthomas/hellobrand --skill clarify-robertsthomas

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

  • Clear copy improvement framework across UI text including error messages, labels, tooltips, empty states, and CTAs
  • Structured process with auditing, rewriting, and validation including concrete examples
  • Use case: reduce support tickets and user frustration by rewriting confusing on-boarding and error prompts

Quick Start

Audit the current UI copy against the clarity principles and propose concrete, user-friendly rewrites for the top three problem areas

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 and confusing error messages in my interface?

Refining confusing UX copy requires applying clarity principles—be specific, concise, active, and helpful—to rewrite error messages and labels. This structured process replaces vague text with actionable, user-friendly language across your product.

What is the best way to rewrite microcopy for UI empty states and loading states?

The best way to rewrite microcopy for empty states and loading states is to audit the current text and apply a structured framework to generate actionable templates. This ensures consistent, user-friendly language that guides users effectively during waiting or blank periods.

When do I need to audit and refine form labels and button text for usability?

You need to audit and refine form labels and button text when users encounter confusing instructions or when you want to reduce support tickets. Applying a clarity framework identifies poorly written UI text and proposes concrete, user-friendly rewrites for better usability.

Can I use a structured framework to fix bad UX writing across navigation and help text?

Yes, you can use a structured framework to fix bad UX writing across navigation and help text. The framework audits existing copy, rewrites unclear instructions according to clarity principles, and validates changes to ensure consistent, user-friendly language across the product.

Why does applying clarity principles to onboarding copy reduce user frustration?

Applying clarity principles to onboarding copy reduces user frustration by replacing hard-to-follow instructions with specific, actionable, and concise text. Rewriting confusing prompts ensures users understand the interface immediately, which directly lowers support tickets and improves usability.