clarify

Identify and improve unclear interface text across web and mobile interfaces.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/han-so1omon/ikam --skill clarify-han-so1omon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/han-so1omon/ikam/tree/main/skills/clarify
Command: npx skills add https://github.com/han-so1omon/ikam --skill clarify-han-so1omon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing.

Core Features & Use Cases

  • Guided improvements of unclear copy across copy surfaces (labels, error messages, tooltips, onboarding copy) to improve clarity and reduce support tickets.
  • Context-driven rewrites that align with product voice and user intent, with measurable readability improvements.
  • Use Case: When a user reports confusing prompts or labels, generate clearer alternatives and document rationale.

Quick Start

Provide a clearer rewrite for the current confusing UI text.

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 confusing interface text?

To improve unclear UX copy, you can analyze existing interface text for clarity issues and apply structured UX writing guidelines to generate concise, helpful rewrites for labels, prompts, and tooltips.

What is the best way to rewrite confusing error messages for better user experience?

Rewriting confusing error messages involves analyzing the current text for user intent and functional requirements, then applying consistent UX writing guidelines to produce context-driven, clear alternatives that reduce support tickets.

How do I fix unclear onboarding copy and bad microcopy in my interface?

Fixing unclear onboarding copy and bad microcopy requires identifying readability problems across web and mobile surfaces, defining an improvement plan, and generating context-driven rewrites aligned with product voice.

Can I use UX writing guidelines to improve readability for mobile and web interfaces?

Yes, UX writing guidelines can be applied to improve readability across both web and mobile interfaces by analyzing copy surfaces like labels and tooltips, then applying structured rewrites for measurable clarity improvements.

Why does confusing microcopy lead to higher support tickets and how can I fix it?

Confusing microcopy leads to higher support tickets because users struggle to understand instructions or error states, which can be fixed by applying guided improvements that align text with user intent and product voice.