clarify

Identify and improve unclear UX copy in web and mobile interfaces.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear UX copy, microcopy, labels, and instructions to help users understand interfaces more quickly and complete tasks with confidence.

Core Features & Use Cases

  • Systematic copy audits that identify jargon, ambiguity, passive voice, and missing context.
  • Actionable rewrites and guidelines aligned to a consistent clarity framework.
  • Context-aware recommendations tailored to audience expertise and user mindset.

Quick Start

Provide a concise audit of the given UI copy and return a revised, user-friendly version following clarity principles.

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 to make interfaces easier to understand?

Improve unclear UX copy by conducting a systematic audit to identify jargon, ambiguity, and passive voice, then apply actionable rewrite guidelines tailored to your audience for clear microcopy and labels.

What is the best way to rewrite error messages and UI labels for better usability?

The best way to rewrite error messages and UI labels is to apply a structured clarity framework that replaces vague instructions with context-aware, actionable text aligned to the user's mindset and expertise level.

Does this approach work for both web and mobile interface content audits?

Yes, this approach works for both web and mobile interfaces, systematically evaluating error messages, placeholders, tooltips, and CTAs to ensure consistent copy improvement across all product handoffs.

How do I audit microcopy for accessibility and clarity during a design review?

Audit microcopy for accessibility by checking labels and instructions for missing context, removing complex jargon, and applying practical rewrite rules to ensure all UI copy supports a11y and usability standards.

When do I need a structured framework to fix unclear UI text?

You need a structured framework to fix unclear UI text when systematic content audits reveal inconsistent labels, ambiguous CTAs, or passive voice that prevent users from completing tasks with confidence.

Why does passive voice in UI copy reduce clarity for users?

Passive voice in UI copy reduces clarity by obscuring the required action and missing context, making it harder for users to understand instructions and complete tasks confidently across web and mobile interfaces.