clarify

Identify and rewrite unclear interface text for web and mobile products.

Updated Dec 19, 2024
One-click install
npx skills add https://github.com/heyramzi/clickup-utils --skill clarify-heyramzi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/heyramzi/clickup-utils/tree/main/.claude/skills/clarify
Command: npx skills add https://github.com/heyramzi/clickup-utils --skill clarify-heyramzi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear, confusing, or poorly written interface text to make products easier to understand and use.

Core Features & Use Cases

  • Clear copy audits: identify jargon, ambiguity, passive voice, excessive length, and missing context.
  • Copy improvements: rewrite error messages, labels, placeholders, and CTAs for clarity and consistency.
  • Use Case: when product teams encounter vague prompts or confusing labels, apply standardized clarity guidelines to produce user-friendly copy that reduces support tickets.

Quick Start

Rewrite the provided UI copy to improve clarity and reduce user confusion.

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 confusing error messages?

To improve unclear UX copy, rewrite error messages, labels, and placeholders by identifying jargon, ambiguity, and passive voice, replacing them with standardized clarity guidelines to reduce user confusion and support tickets.

What is the best way to audit microcopy for usability issues?

Auditing microcopy for usability involves identifying jargon, ambiguity, passive voice, excessive length, and missing context across interface text to ensure product understandability and improve the overall user experience.

Can I use this to rewrite onboarding and form labels for better clarity?

Yes, you can rewrite onboarding and form labels for better clarity by applying standardized copy improvements to web and mobile interfaces, enhancing feature guidance, placeholders, and calls to action.

Does UX writing for mobile interfaces require different copy guidelines?

UX writing for mobile interfaces applies the same clarity guidelines to identify confusing text and rewrite microcopy, ensuring consistent and user-friendly labels and error messages across both web and mobile platforms.

Why do vague prompts and confusing labels increase support tickets?

Vague prompts and confusing labels increase support tickets because poorly written interface text lacks context and clarity, causing user frustration and making products harder to understand and navigate.

When should I not use automated copywriting for interface text?

You should not use automated copywriting for interface text when your product requires highly specific brand voice alignment or complex legal phrasing that exceeds standard microcopy clarity guidelines and usability improvements.