clarify

Clarify unclear UX copy across onboarding, errors, forms, CTAs, and help text.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clarify unclear UX copy to reduce user confusion and support tickets.

Core Features & Use Cases

  • Provides a structured approach to identify unclear copy, including common issues like jargon, ambiguity, passive voice, length, missing context, and tone mismatches.
  • Outlines a practical plan for copy improvement with primary message, required actions, tone, and constraints.
  • Demonstrates a systematic method to implement: error messages, form labels, help text, empty states, and success messages.

Quick Start

Rewrite the target screen copy to improve clarity for a specific user task.

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 user interface?

To improve unclear UX copy, you need a structured approach to identify issues like jargon, ambiguity, and passive voice across onboarding text, error messages, and form labels. This reduces user confusion and support tickets.

What is the best way to rewrite error messages for clarity?

The best way to rewrite error messages for clarity is to apply a principle-driven framework that defines the primary message, required actions, tone, and constraints. This ensures your error messages are actionable and consistent.

Why does my onboarding copy cause user confusion?

Your onboarding copy likely causes user confusion because it contains common issues such as jargon, ambiguity, missing context, or tone mismatches. Identifying these specific problems allows you to rewrite the text for better usability.

How do I fix unclear form labels and help text?

To fix unclear form labels and help text, systematically rewrite the target screen copy to align with a specific user task. This involves outlining the primary message and constraints to ensure consistent, actionable improvements.

Can I use a structured framework to fix empty states and success messages?

Yes, you can use a structured framework to fix empty states and success messages. It provides a systematic method to implement copy improvements by defining the required actions, tone, and core message for each product surface.

When do I need to rewrite CTA text for better usability?

You need to rewrite CTA text for better usability when users experience confusion or submit support tickets due to ambiguous or lengthy copy. A structured improvement plan helps clarify the primary message and required actions.