clarify

Analyze and refine UI copy for jargon, ambiguity, and tone.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/uniquesonu/verdian-group --skill clarify-uniquesonu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/uniquesonu/verdian-group/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/uniquesonu/verdian-group --skill clarify-uniquesonu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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 tone mismatches in UX copy.
  • Contextual Improvement: Tailors copy based on audience, user mental state, and action constraints.
  • Use Case: Improving error messages on a login form to clearly explain why a login failed and how to fix it, rather than showing a generic "Authentication failed" message.

Quick Start

Use the clarify skill to improve the error message "Invalid input" for a username field.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I improve UX writing for clarity in my user interface?

To improve UX writing for clarity, analyze interface text for jargon, ambiguity, and passive voice. Refine microcopy, error messages, and labels based on audience, user mental state, and action context to make digital products more intuitive.

What is the best way to write clear error messages for a login form?

Writing clear error messages involves explaining why an action failed and how to fix it. Instead of showing a generic authentication failed message, tailor the microcopy to the specific user state and action constraints to guide the user.

How do I fix ambiguous microcopy and passive voice in my application?

Fixing ambiguous microcopy requires assessing the text for tone mismatches and passive voice. Enhance the copy by tailoring it to the audience and action context, transforming confusing interface text into clear, actionable instructions.

Can I use this approach to refine UX copy for specific user mental states?

Yes, you can refine UX copy for specific user mental states. Contextual improvement tailors labels and instructions based on the audience, user state, and action constraints, ensuring the microcopy addresses the user's current situation.

Does improving UX copy clarity require understanding specific interface elements?

Yes, improving UX copy clarity requires understanding UX writing principles and common interface elements. This knowledge allows you to accurately assess and refine text like error messages, microcopy, and instructions for maximum usability.

Why does generic interface text cause usability problems?

Generic interface text causes usability problems because it lacks contextual relevance. Poorly written copy fails to address the audience or user action context, leaving users confused by jargon, ambiguity, and tone mismatches during critical interactions.