clarify

Rewrite unclear UX copy across interfaces for clarity and actionability.

Updated Nov 25, 2025
One-click install
npx skills add https://github.com/1IssaMohamed/IEEE-YorkU --skill clarify-1issamohamed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/1IssaMohamed/IEEE-YorkU/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/1IssaMohamed/IEEE-YorkU --skill clarify-1issamohamed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.

Core Features & Use Cases

  • Systematically identify jargon, ambiguity, passive voice, length issues, missing context, and tone mismatches in UI copy.
  • Provide a structured plan to rewrite error messages, form labels, tooltips, help text, and empty states for better comprehension and actionability.
  • Real-world use: transform ambiguous onboarding prompts into clear, actionable steps that reduce user friction and support tickets.

Quick Start

Provide an example of unclear copy and request a rewritten, clearer version.

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 for better clarity?

Rewrite unclear UX copy by replacing jargon and passive voice with actionable, audience-aware language. This process systematically improves error messages, form labels, and tooltips to reduce user friction and support tickets.

What is microcopy and how does it affect user experience?

Microcopy is the small-scale user-facing text in interfaces like onboarding prompts, tooltips, and empty states. Improving microcopy clarity directly enhances user experience by providing specific context and actionable guidance, reducing confusion.

How do I fix confusing onboarding prompts and form labels?

Fix confusing onboarding prompts and form labels by identifying ambiguity, length issues, and tone mismatches. Rewriting this UI copy transforms vague steps into clear, actionable instructions that measurably improve user comprehension.

Does UX writing for multi-platform interfaces require consistent terminology?

UX writing for multi-platform interfaces requires consistent terminology to ensure measurable clarity improvements. Applying audience-aware language and actionable guidance across all user-facing copy maintains a unified experience.

When should I improve UI copy instead of redesigning the interface?

Improve UI copy when interfaces are difficult to understand due to jargon, missing context, or poorly written text. Systematically rewriting microcopy and help text resolves comprehension issues without requiring a full design redesign.

Can I integrate UX copy improvements directly into design workflows?

UX copy improvements can be reviewed and integrated directly into design workflows. The process provides structured rewrites for labels and error messages, ensuring actionable guidance is applied consistently across the product.