clarify

Assess and rewrite unclear UX copy across interfaces.

184|16|Updated Mar 22, 2025
One-click install
npx skills add https://github.com/zhushen12580/smart-screenshot --skill clarify-zhushen12580
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/zhushen12580/smart-screenshot/tree/main/.claude/skills/clarify
Command: npx skills add https://github.com/zhushen12580/smart-screenshot --skill clarify-zhushen12580

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear, confusing, or poorly written interface text to make the product easier to understand. It targets UX copy, error messages, microcopy, labels, and instructions, and is useful when users mention confusing text, unclear labels, or want better UX writing.

Core Features & Use Cases

  • Assess current copy and identify clarity problems (jargon, ambiguity, passive voice, length, missing context, tone mismatch).
  • Plan and implement copy improvements with a structured, human-centered approach covering error messages, form labels, button text, tooltips, help text, and empty states.
  • Validate improvements by applying consistency and clarity principles, and provide examples and guidance for future copy.

Quick Start

Review the target interface copy and provide a clarified, ready-to-use revision that aligns with the brand voice and usability guidelines.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I improve confusing UX copy and unclear interface labels?

To improve UX copy, you must assess current text for jargon, ambiguity, and passive voice, then plan and implement clear, consistent revisions using plain language to reduce user confusion across all product interfaces.

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

The best way to rewrite error messages is to apply a structured workflow that assesses current copy, identifies missing context or tone mismatch, and implements plain language revisions aligned with brand voice to improve usability.

How do I fix confusing microcopy and tooltips in my product?

You fix confusing microcopy and tooltips by validating improvements against consistency and clarity principles, replacing ambiguous text with human-centered instructions that provide missing context and align with usability guidelines.

Can I use a structured workflow to align button text and help text with my brand voice?

Yes, you can enforce a structured workflow to assess current copy, plan improvements, and implement clear button text and help text that aligns with your brand voice and plain language usability guidelines.

When do I need to revise empty states and form labels for clarity?

You need to revise empty states and form labels when users encounter confusing text, missing context, or tone mismatch, applying a structured approach to implement clear, consistent copy that improves overall product usability.