clarify

Identify and rewrite unclear UX copy, error messages, and labels.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/igot-ai/os-twin --skill clarify-igot-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/igot-ai/os-twin/tree/main/.agents/skills/roles/engineer/clarify
Command: npx skills add https://github.com/igot-ai/os-twin --skill clarify-igot-ai

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 and rewrite unclear copy across UI elements.
  • Align tone, length, and terminology with product voice.
  • Real-world example: streamline an onboarding flow where labels cause confusion and drop-off.

Quick Start

Use a concise, ready-to-implement copy improvement for the target UI element.

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 and error messages to improve usability?

To rewrite unclear UX copy and error messages, analyze the text across interface contexts to identify confusion points, then optimize terminology, tone, and length to align with the product voice and reduce user drop-off.

What is UX writing and when do I need to optimize microcopy?

UX writing is the practice of crafting clear microcopy, labels, and instructions for interfaces. You need to optimize it when confusing text, bad error messages, or hard-to-follow instructions cause user friction and drop-off.

How do I fix confusing onboarding flow labels that cause user drop-off?

Fix confusing onboarding flow labels by analyzing the copy across the user journey, identifying unclear instructions, and rewriting the text to provide concise, ready-to-implement guidance that streamlines the experience.

Can I align form help text and notifications with my product voice?

Yes, you can align form help text and notifications with your product voice by analyzing the existing copy across feedback loops and rewriting it to match the desired tone, terminology, and length for consistent design communication.

What is the best way to streamline unclear instructions in a user interface?

The best way to streamline unclear instructions is to apply a structured analysis protocol that evaluates the text across UI elements and outputs optimized, ready-to-implement copy tailored to specific interaction contexts.