clarify

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

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/yahya-azeem/Pokedex --skill clarify-yahya-azeem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/yahya-azeem/Pokedex/tree/main/library/impeccable/skills/clarify
Command: npx skills add https://github.com/yahya-azeem/Pokedex --skill clarify-yahya-azeem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill improves unclear UX copy so users understand what a screen means, what to do next, and how to recover when something goes wrong.

Core Features & Use Cases

  • Diagnoses clarity failures in microcopy, labels, instructions, and error messages (jargon, ambiguity, passive voice, missing context, tone mismatch, and length).
  • Rewrites with an audience-aware plan by incorporating the user’s mental state, technical level, desired action, and constraints like length or format.
  • Upgrades common UI text surfaces including errors, form labels and instructions, CTAs, tooltips/help text, empty/loading/success states, confirmation dialogs, and navigation/wayfinding.
  • Applies UX writing rules (specific, concise, active voice, empathetic tone, consistent terminology, and actionable guidance) and verifies improvements for comprehension and actionability.

Quick Start

Use the clarify skill to improve the UI text in your product by asking it to rewrite your current confusing label and error message while matching the established tone and stating what the user should do next.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite confusing UX copy and error messages for better clarity?

Rewriting confusing UX copy involves diagnosing clarity failures like jargon and passive voice, then refining microcopy and error messages with active voice and actionable guidance to ensure users understand what to do next. This skill rewrites labels and instructions to eliminate ambiguity and missing context.

What is the best way to improve form labels and microcopy for product onboarding?

Improving form labels and microcopy for product onboarding requires applying UX writing rules such as conciseness, specific terminology, and empathetic tone. This skill analyzes your current interface text and upgrades it by incorporating the user's technical level and desired action to produce actionable, consistent copy.

How do I fix error messages that lack context and fail to guide users?

Fixing error messages that lack context involves rewriting them to state what went wrong and what the user should do next. This skill diagnoses tone mismatches and missing context in your UI text, then applies UX writing rules to verify that error messages and confirmation dialogs are empathetic and actionable.

Can I use this skill to update empty, loading, and success state text?

Yes, you can use this skill to update empty, loading, and success state text. It upgrades common UI text surfaces including tooltips, help text, and navigation wayfinding by gathering audience mental-state context and producing more actionable, empathetic, and consistent microcopy across your interface.

Does rewriting microcopy with this skill require existing frontend design assets?

Rewriting microcopy with this skill requires following the Impeccable frontend design preparation protocol. It does not depend on external dependencies but needs audience and user mental-state context to accurately match your established tone and produce consistent, actionable guidance for your interface.