clarify

Analyze UX copy for jargon, ambiguity, and passive voice, then refine it.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of unclear, confusing, or poorly written interface text, making digital products more intuitive and user-friendly.

Core Features & Use Cases

  • Clarity Assessment: Identifies jargon, ambiguity, passive voice, and other clarity issues in UX copy.
  • Contextual Improvement: Tailors copy based on audience, user state, and action.
  • Systematic Refinement: Provides specific guidance for improving error messages, labels, button text, and more.
  • Use Case: A product team can use this Skill to review and rewrite error messages for a new feature, ensuring users understand what went wrong and how to fix it.

Quick Start

Improve the clarity of the error message "Operation failed" for a file upload feature.

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 and error messages for better user understanding?

Improve unclear UX copy by analyzing text for jargon, ambiguity, and passive voice, then refining it based on audience and context. This ensures error messages, labels, and instructions are clear, concise, and human-centered.

What is the best way to rewrite confusing microcopy for a user interface?

The best way to rewrite confusing microcopy is to assess it for tone mismatch and ambiguity, then systematically refine the text to match the user's state and desired action across various interface elements.

How do I fix vague error messages like "Operation failed" in a file upload feature?

Fix vague error messages by replacing generic failure text with specific, actionable guidance. Refine the copy to explain exactly what went wrong and provide clear steps for the user to resolve the issue.

Can I use this approach to review button labels and instructions for a new product feature?

Yes, you can use this approach to review button labels and instructions. It systematically identifies jargon and provides tailored improvements to ensure your new feature remains intuitive and user-friendly.

Why does passive voice reduce clarity in user interface text?

Passive voice reduces clarity in user interface text by obscuring the subject performing the action. Identifying and refining passive constructions ensures your copy clearly communicates the desired action to the user.

Does UX writing refinement work for adjusting tone across different audiences?

Yes, UX writing refinement works for adjusting tone. It analyzes your text for tone mismatch and tailors the microcopy based on the specific audience, user state, and context to enhance usability.