clarify

Audit and rewrite unclear UI copy across error messages, labels, and tooltips.

Updated Apr 19, 2025
One-click install
npx skills add https://github.com/adperem/adperem.github.io --skill clarify-adperem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/adperem/adperem.github.io/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/adperem/adperem.github.io --skill clarify-adperem

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

  • UX copy audit and rewriting for clarity across error messages, labels, tooltips, and onboarding.
  • Plan and implement a clear copy strategy with primary message, action steps, tone, and constraints.
  • Provide templates and examples to ensure consistent language across products.

Quick Start

Run a UX copy clarity audit on your first screen and return a rewritten version following the guidelines.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite confusing UX copy and error messages for better clarity?

To improve UX copy clarity, audit existing error messages, labels, and tooltips to identify confusing text, then rewrite them following a structured plan of primary message, action steps, tone, and constraints to ensure user-centered interface text.

What is the best way to audit unclear UI labels and onboarding microcopy?

The best way to audit unclear UI labels and onboarding microcopy is to run a structured UX writing clarity assessment that identifies poorly written interface text and returns a rewritten, approachable version following consistent language guidelines.

Can I use this approach to improve both web and mobile app interface text?

Yes, you can use this UX copy clarity approach to improve interface text across both web and mobile apps, specifically targeting forms, buttons, tooltips, and onboarding guidance where user comprehension and clear instructions are critical.

How do I plan a consistent UX copywriting strategy for my product's interface?

Plan a consistent UX copywriting strategy by defining the primary message, action steps, tone, and constraints for your interface, then applying these guidelines across error messages, labels, and microcopy to ensure a unified user experience.

Why does my onboarding flow have high drop-off rates due to bad UI copy?

Onboarding flows suffer high drop-off rates when UI copy contains confusing labels, hard-to-follow instructions, or unclear error messages, which prevents users from understanding the interface and completing required actions successfully.