clarify

Diagnoses unclear UI text and rewrites it for clarity and consistency.

Updated Nov 15, 2025
One-click install
npx skills add https://github.com/billh93/snchz --skill clarify-billh93
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/billh93/snchz/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/billh93/snchz --skill clarify-billh93

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many interfaces suffer from unclear UX copy—labels, error messages, and microcopy that confuse users, hinder task completion, and increase support needs.

Core Features & Use Cases

  • Diagnose unclear copy across error messages, labels, tooltips, and calls to action to identify friction points.
  • Propose concrete rewrites and templates aligned with a consistent tone and user mental model.
  • Apply guidance to onboarding, forms, error flows, and help hints to improve comprehension and task success.

Quick Start

Review the current interface copy and rewrite unclear error messages, labels, and tooltips for clarity.

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 user interface labels and error messages?

To improve unclear UX copy, rewrite interface labels and error messages to be specific, concise, active, human, helpful, and consistent. This reduces user confusion and support tickets by aligning microcopy with user mental models across onboarding, forms, and help tips.

What is the best way to rewrite microcopy for clearer user interfaces?

The best way to rewrite microcopy for clearer user interfaces is to diagnose friction points across tooltips and calls to action, then apply structured clarity principles to generate concrete phrasing templates that improve task comprehension and success rates.

Why do users get confused by error messages and how can I fix them?

Users get confused by error messages when copy hinders task completion and increases support needs. Fix them by applying structured copy guidelines that emphasize active, human, and helpful phrasing, producing a formatted plan with recommended rewrites for error flows.

Can I use UX writing guidelines to fix onboarding and form microcopy?

Yes, you can apply UX writing guidelines to fix onboarding and form microcopy. Diagnose unclear copy across these flows and generate concrete rewrites aligned with a consistent tone and user mental model to improve comprehension and reduce friction.

When should I update interface copy to reduce support tickets?

Update interface copy to reduce support tickets when labels, error messages, and help tips hinder user tasks. Rewriting microcopy for clarity across onboarding, forms, and help hints improves task success and reduces user confusion.

What principles should I follow to rewrite unclear UX copy for product interfaces?

Follow clarity principles that are specific, concise, active, human, helpful, and consistent. Apply these structured copy guidelines to diagnose friction points and output a formatted plan with recommended phrasing for labels, error messages, and tooltips.