skills.rest
TudeOrangBiasa
TudeOrangBiasaCOMMUNITY
Explore all skills by this author →
GitHub

clarify

Analyze UI copy for jargon, ambiguity, passive voice, and tone.

Updated Aug 27, 2026
Search Tags:#clarity#microcopy#copywriting#ux writing#user interface#error messages
One-click install
npx skills add https://github.com/TudeOrangBiasa/zenithgravity-kit --skill clarify-tudeorangbiasa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/TudeOrangBiasa/zenithgravity-kit/tree/main/.agent/skills/clarify
Command: npx skills add https://github.com/TudeOrangBiasa/zenithgravity-kit --skill clarify-tudeorangbiasa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses confusing, unclear, or poorly written text within user interfaces, making products more understandable and user-friendly.

Core Features & Use Cases

  • Clarity Assessment: Identifies jargon, ambiguity, passive voice, and tone mismatches.
  • Contextual Improvement: Tailors copy for specific audiences, user states, and actions.
  • Systematic Refinement: Offers specific guidance for improving error messages, labels, button text, and more.
  • Use Case: Improve the clarity of an error message that currently reads "Operation failed" to something more helpful like "Could not save your changes. Please check your internet connection and try again."

Quick Start

Use the clarify skill to improve the error message for the user login form.

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 in my user interface?▼

To improve unclear UX copy, you refine error messages, labels, and instructions by analyzing text for jargon, ambiguity, and passive voice. This process replaces vague microcopy like operation failed with helpful, actionable user interface text.

What is the best way to rewrite confusing microcopy for specific audiences?▼

The best way to rewrite confusing microcopy involves assessing text for tone mismatches and ambiguity, then systematically refining instructions for specific user states. This tailors user interface text to match contextual audience needs and actions.

How do I fix an unhelpful error message so users know what action to take next?▼

To fix an unhelpful error message, you replace vague failure alerts with specific, actionable guidance. This refines the copy to explain the issue, such as checking an internet connection, making the user interface easier to understand.

Can I use automated clarity assessment to identify jargon and passive voice in my UI labels?▼

Yes, a clarity assessment can identify jargon and passive voice in your UI labels. It analyzes your user interface text to pinpoint tone mismatches and ambiguous microcopy, ensuring your instructions remain concise and helpful.

Why does my button text confuse users and how can I make it clearer?▼

Your button text confuses users due to ambiguity, jargon, or tone mismatches. You make microcopy clearer by applying systematic refinement principles, ensuring button labels and instructions are concise, direct, and tailored to user actions.

Related Skills

Explore More Design & Creative Skills→
yeshan333yeshan333
94

clarify

Rewrite user interface copy for clarity and usability.

Community
Intermediate
tomada1114tomada1114
4

designing-wireframes

Design ASCII wireframes and UX flows from detailed requirements.

Community
Basic
xoaixoai
25

ux-specify

Enrich feature specifications with UX requirements, error states, and accessibility notes.

Community
Intermediate
wen-chenwen-chen
7

dr-cook:chinese-polisher

Polish Chinese academic writing with three sequential passes for grammar, vocabulary, and fluency.

Community
Advanced