clarify

Rewrite unclear UI copy into precise, actionable instructions for web and mobile interfaces.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clear, concise, and user-friendly UI copy that reduces confusion and errors by rewriting unclear interface text across error messages, labels, and microcopy.

Core Features & Use Cases

  • Copy rewriting: Turn vague terms into precise, actionable instructions that align with product tone.
  • Consistency & tone: Harmonize naming, labels, and error messages across the product.
  • Use Case: For example, rewrite an ambiguous error like "Invalid input" into "Please enter a valid email address" and keep brand voice.

Quick Start

Provide a revised copy for a sample UI message to improve clarity.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite unclear UI copy for better clarity and usability?

To rewrite UI copy for clarity, transform vague interface text into precise, actionable instructions while preserving your brand voice. This process targets error messages, labels, placeholders, and tooltips across web and mobile interfaces to reduce user confusion and errors.

What's the best way to write clear error messages for a web or mobile interface?

Writing clear error messages involves replacing ambiguous terms like "Invalid input" with concrete, actionable alternatives such as "Please enter a valid email address." This ensures users understand the exact problem and how to resolve it within typical UI constraints.

How do you harmonize microcopy tone and consistency across a product?

Harmonizing microcopy tone and consistency involves standardizing naming, labels, and error messages across the product. By aligning rewrites with your established product tone, vague terms become precise instructions that maintain a unified brand voice.

Can I use UX writing techniques to fix jargon in onboarding copy?

Yes, UX writing techniques can fix jargon in onboarding copy by avoiding technical terms and providing concrete, actionable alternatives. This approach ensures new users receive clear, user-friendly instructions that fit standard UI constraints without confusion.

When do I need to revise placeholders and tooltips for UX clarity?

You need to revise placeholders and tooltips for UX clarity when interface text becomes vague or causes user errors. Rewriting these microcopy elements ensures they provide precise, actionable guidance that aligns with the product tone across web and mobile platforms.