clarify

Rewrite unclear UX copy into concise, actionable interface text.

Updated Jan 24, 2026
One-click install
npx skills add https://github.com/Ikki-Group/erp --skill clarify-ikki-group
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/Ikki-Group/erp/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/Ikki-Group/erp --skill clarify-ikki-group

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

  • Clarity audit: Identify jargon, ambiguity, passive voice, and overly long copy.
  • Copy rewriting: Produce concise, actionable rewrites that follow clarity principles.
  • Guidance for teams: Provide best-practice recommendations for labels, placeholders, error messages, and tooltips.

Quick Start

Rewrite this unclear UX copy into clear, user-friendly text.

Frequently Asked Questions about clarify

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

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

Rewrite unclear UX copy by identifying jargon, ambiguity, and passive voice, then replacing them with concise, actionable text. This process ensures error messages, labels, and microcopy are easy to understand and follow clarity principles.

What makes bad error messages hard to follow in web and mobile apps?

Bad error messages are hard to follow when they use technical jargon, passive voice, or lack actionable guidance. Auditing this UX copy helps identify these issues and replace them with clear, user-friendly instructions.

How do I audit microcopy for clarity and usability?

Audit microcopy for clarity by checking labels, placeholders, and tooltips for overly long text and ambiguity. This identifies confusing copy and provides best-practice recommendations to improve overall interface usability.

Can I use this to improve UX writing for both web and mobile interfaces?

Yes, you can improve UX writing for both web and mobile apps. It applies clarity principles to error messages, labels, and microcopy across platforms, ensuring concise and actionable text for all user interfaces.

What is the best way to write clear tooltips and placeholders?

The best way to write clear tooltips and placeholders is to apply clarity principles that prioritize conciseness and actionable guidance. This ensures the microcopy effectively guides users without introducing unnecessary jargon or ambiguity.