clarify

Rewrite unclear UI copy across error messages, labels, tooltips, empty states, and prompts.

1|1|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/joncoronel/skillstack --skill clarify-joncoronel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/joncoronel/skillstack/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/joncoronel/skillstack --skill clarify-joncoronel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.

Core Features & Use Cases

  • Provide a structured framework to assess copy quality across error messages, labels, tooltips, empty states, and prompts.
  • Propose precise rewrites to improve clarity, tone, and actionability while preserving brand voice.
  • Include guidelines for consistency, context, and accessibility in UI copy.

Quick Start

Use a real-world prompt to rewrite a confusing error message into clear, actionable copy.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite unclear UI copy for better user understanding?

Rewriting unclear UI copy involves applying a structured framework to assess text quality across error messages, labels, tooltips, and empty states. This process proposes precise rewrites to improve clarity, tone, and actionability while preserving brand voice.

What is the best way to write clear error messages in a product interface?

Writing clear error messages requires assessing existing copy for confusion and proposing precise rewrites that are actionable. The rewritten text must satisfy clarity, consistency, accessibility, and brand-voice requirements to improve product usability.

Can I use UX writing guidelines to improve tooltips and empty states?

Yes, UX writing guidelines can improve tooltips and empty states by providing a structured framework to assess copy quality. This approach ensures the rewritten text meets context, consistency, and accessibility requirements across the product interface.

How do I make confusing interface labels easier for users to understand?

Making confusing interface labels easier to understand involves identifying poorly written text and proposing precise rewrites. The rewrites improve user comprehension by satisfying clarity, consistency, and accessibility standards while maintaining brand voice.

Does rewriting UI copy require maintaining the existing brand voice?

Yes, rewriting UI copy requires preserving the existing brand voice. The rewriting process improves clarity, tone, and actionability across error messages and prompts while deliberately maintaining the product's established brand-voice requirements.