clarify

Rewrite unclear UX copy into clear, actionable interface text.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/delbyte/ciao-bello-website --skill clarify-delbyte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/delbyte/ciao-bello-website/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/delbyte/ciao-bello-website --skill clarify-delbyte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unclear UX copy creates confusion, slows tasks, and increases support requests. This skill helps identify and rewrite ambiguous microcopy to boost clarity and usability.

Core Features & Use Cases

  • Identify clarity problems: jargon, ambiguity, passive voice, overly long or terse text, missing context, and tone mismatches.
  • Plan copy improvements: determine the primary message, required user action, tone, and constraints.
  • Apply systematic improvements: rewrite error messages, form labels, button text, help text, empty states, and success messages for consistent clarity.
  • Verification: ensure rewritten copy is clear, actionable, and aligned with existing terminology across the product.

Quick Start

Provide the original copy and the context, then rewrite it following the guidance above.

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

To improve unclear UX copy, provide the original interface text and its context to identify jargon, ambiguity, and passive voice, then systematically rewrite labels, tooltips, and help text into clear, actionable microcopy.

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

The best way to rewrite error messages for usability is to determine the primary message and required user action, then apply systematic improvements to ensure the text is clear, actionable, and aligned with existing product terminology.

How do I fix ambiguous microcopy like form labels and empty states?

To fix ambiguous microcopy, identify clarity problems such as missing context or tone mismatches, then rewrite form labels, empty states, and success messages to establish consistent clarity and boost task completion.

Can I use this approach to plan copy improvements for button text and tooltips?

Yes, you can plan copy improvements for button text and tooltips by defining the primary message, tone, and constraints, then verifying the rewritten interface text is clear and actionable across the product.

Why does unclear interface text increase support requests and how do I prevent it?

Unclear interface text increases support requests by creating confusion and slowing tasks; you prevent this by identifying jargon and overly long text, then systematically rewriting help text to boost usability.