clarify

Identify unclear UX copy and propose clearer alternatives for interface text.

Updated Aug 12, 2023
One-click install
npx skills add https://github.com/ky-zo/kyzo --skill clarify-ky-zo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/ky-zo/kyzo/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/ky-zo/kyzo --skill clarify-ky-zo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear UX copy, error messages, microcopy, labels, and instructions. Make interfaces easier to understand and use.

Core Features & Use Cases

  • Identify and rewrite unclear copy across UI elements such as labels, error messages, placeholders, and CTAs.
  • Provide rationale and style guidance to align with product tone and accessibility considerations.
  • Use case: When reviewing onboarding screens or help content, propose clearer wording to reduce user confusion and support tickets.

Quick Start

Provide the unclear copy and context; return a revised, clearer version with rationale.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite unclear UX copy for better clarity?

To rewrite unclear UX copy, provide the existing text and its interface context to identify ambiguous phrasing and generate clearer alternatives. This process applies clarity principles to labels, error messages, tooltips, and microcopy while preserving the product's original tone and constraints.

What is the best way to improve confusing form labels and error messages?

The best way to improve confusing form labels and error messages is to evaluate the existing copy against usability principles and propose clearer wording. This approach provides rationale for revisions and ensures the updated text reduces user confusion across web and mobile interfaces.

Can I use microcopy revisions for mobile onboarding screens?

Yes, you can use microcopy revisions for mobile onboarding screens. The process evaluates interface text across web and mobile platforms, proposing clearer wording for help content and instructions to reduce user confusion and minimize support tickets.

Does UX copy rewriting preserve my product's existing tone?

UX copy rewriting preserves your product's existing tone by applying clarity principles within your defined constraints. Revisions include style guidance and rationale to ensure the updated microcopy, labels, and CTAs align with your product voice and accessibility considerations.

Why should I revise placeholder text and tooltips for usability?

You should revise placeholder text and tooltips for usability because unclear UI elements increase user friction and support tickets. Identifying and rewriting ambiguous microcopy ensures instructions are easy to understand, directly improving the overall user experience.

How do I fix unclear CTA copy in my interface?

To fix unclear CTA copy, analyze the existing call-to-action text and propose clearer alternatives that follow usability principles. This ensures the revised CTA copy is easy to understand, provides rationale for the change, and maintains the product's tone.