skills.rest
hossain-khan
hossain-khanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/hossain-khan/hk-vision-slideshow --skill clarify-hossain-khan
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Design & Creative Skills→
yahya-azeemyahya-azeem

clarify

Rewrites unclear UX interface text including labels, instructions, and error messages.

Community
Intermediate
bfree-trainerbfree-trainer
60

clarify

Rewrite unclear UI copy to reduce jargon and ambiguity.

Official
Intermediate
tomada1114tomada1114
4

designing-wireframes

Design ASCII wireframes and UX flows from detailed requirements.

Community
Basic
andrewgleaveandrewgleave
31

writing-for-interfaces

Review and improve UI copy for clarity, purpose, and consistency.

Community
Intermediate