i-clarify

Identify and rewrite unclear UX copy in web and mobile interfaces.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/mberetvas/blauw_zwart_pipeline --skill i-clarify-mberetvas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: i-clarify
Source: https://github.com/mberetvas/blauw_zwart_pipeline/tree/main/.agents/skills/i-clarify
Command: npx skills add https://github.com/mberetvas/blauw_zwart_pipeline --skill i-clarify-mberetvas

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

  • Identify clarity problems in copy, including jargon, ambiguity, passive voice, and missing context.
  • Propose concrete rewrites for labels, error messages, tooltips, and onboarding text to match user mental models.
  • Real-world use: rewrite a confusing instruction in a settings screen to reduce user confusion and support tickets.

Quick Start

Rewrite the provided UI copy to be clearer and more user-friendly.

Frequently Asked Questions about i-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 clearer interfaces?

To rewrite confusing UX copy, identify jargon, ambiguity, and passive voice in your text, then apply clarity principles to match user mental models. This produces ready-to-use rewritten labels, error messages, and microcopy that reduce user confusion.

What is UX writing clarity and why do my interface labels need it?

UX writing clarity ensures interface text is easy to understand by removing jargon and missing context. Clear labels, instructions, and tooltips align with user mental models, making web and mobile products more usable and reducing support tickets.

How do I fix bad error messages and unclear microcopy in my web app?

Fix bad error messages by identifying clarity problems like passive voice and missing context. Propose concrete rewrites for error messages and microcopy that match user mental states, providing practical examples for immediate use in your interface.

Can I use this to improve onboarding text and tooltips for mobile experiences?

Yes, you can improve onboarding text and tooltips for mobile experiences by identifying unclear copy and applying established clarity principles. It maintains your existing tone while providing rewritten text tailored to diverse contexts and user mental states.

What is the best way to clarify instructions in a settings screen?

The best way to clarify settings instructions is identifying ambiguity and jargon, then proposing concrete rewrites that match user mental models. This approach reduces user confusion and support tickets by ensuring instructions are immediately understandable.

When should I not rewrite UX copy using automated clarity principles?

Avoid rewriting UX copy when your interface text relies on specific legal terminology or strict brand voice guidelines that override standard clarity principles. Always ensure rewritten microcopy and labels maintain your established tone before implementation.