clarify

Identify and rewrite unclear interface text with rationale and verification plans.

Updated Mar 13, 2026

Search Tags:#design #writing #clarity #microcopy #usability #interface #ux-copy

Ready to run

npx skills add https://github.com/hossain-khan/hk-vision-slideshow --skill clarify-hossain-khan

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/hossain-khan/hk-vision-slideshow/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/hossain-khan/hk-vision-slideshow --skill clarify-hossain-khan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

Identify and audit unclear or confusing copy across UI elements like labels, placeholders, error messages, tooltips, and onboarding text.
Provide structured rewrite recommendations with rationale, examples, and alignment to design principles (Context Gathering Protocol, audience context, and tone).
Verify improvements with actionable checks and example scenarios, ensuring consistency and clarity across products.

Quick Start

Provide a sample UI copy and context so I can propose a clearer rewrite ready for review.

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

Rewriting confusing microcopy involves identifying poorly written interface text across UI elements and providing actionable alternatives. You receive structured rewrite recommendations with rationale and a verification plan to validate improved clarity and usability.

What is the best way to audit error messages for usability and clarity?▼

Auditing error messages for usability involves scoping edits across relevant UI scenarios using a Context Gathering Protocol. This approach delivers actionable rewrite recommendations with rationale and a verification plan to validate improved clarity.

Can I use this to rewrite onboarding text and tooltips for better clarity?▼

Yes, you can rewrite onboarding text and tooltips by applying a Context Gathering Protocol to scope edits across relevant UI scenarios. This approach delivers actionable rewrite recommendations with rationale, ensuring your interface text is crystal clear and usable.

How do I verify that my rewritten interface text actually improves usability?▼

You verify improved usability by applying a brief verification plan with actionable checks and example scenarios. This validation step ensures consistency and clarity across products by confirming the new interface text resolves the original confusion.

Does this approach require specific frontend frameworks to audit interface labels?▼

No specific frontend frameworks are required to audit interface labels. The approach applies frontend-design context and a Context Gathering Protocol to scope edits, delivering actionable rewrite recommendations regardless of your underlying tech stack.