clarify

Identify and rewrite unclear interface copy across web and mobile interfaces.

Updated Jul 5, 2025
One-click install
npx skills add https://github.com/nsuberi/proto-portal-showcase-hub --skill clarify-nsuberi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/nsuberi/proto-portal-showcase-hub/tree/main/apps/ai-builders-portal/.claude/skills/clarify
Command: npx skills add https://github.com/nsuberi/proto-portal-showcase-hub --skill clarify-nsuberi

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 clarity problems in UI text (jargon, ambiguity, tone, length) and reveal hidden assumptions.
  • Propose clear, actionable rewrites for labels, error messages, tooltips, placeholders, and onboarding copy.
  • Apply rewritten copy across interfaces to improve usability and reduce support friction, with real-world examples.

Quick Start

Provide the unclear UI text and context, and I will deliver a clear, user-friendly rewrite.

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 to improve usability?

To rewrite unclear UX copy, identify clarity problems like jargon and ambiguity, then apply actionable rewrites to error messages, labels, and tooltips to reduce user confusion and support friction.

What's the best way to fix confusing error messages in a UI?

Fixing confusing error messages involves replacing vague or technical language with clear, actionable text that explains the problem and guides the user, ensuring consistency with the product's voice and accessibility standards.

How do I make interface labels easier to understand?

Making interface labels easier to understand requires identifying hidden assumptions and ambiguous wording, then rewriting the microcopy to be clear, concise, and aligned with existing UI guidelines.

Can I use UX writing best practices for both web and mobile interfaces?

Yes, you can apply UX writing best practices across web and mobile interfaces by rewriting tooltips, placeholders, and onboarding copy to ensure consistent tone and clarity on all platforms.

When do I need to revise microcopy for accessibility?

Revise microcopy for accessibility when interface text contains jargon, excessive length, or unclear instructions, ensuring the rewritten copy meets accessibility standards and reduces user confusion.

Why does my onboarding copy confuse users?

Onboarding copy confuses users when it contains hard-to-follow instructions, jargon, or ambiguous tone, which can be resolved by applying clear, user-friendly rewrites that reveal and address hidden assumptions.