clarify

Rewrite unclear UX copy into clear, actionable interface text.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/primaERP/jmhz-xml-editor --skill clarify-primaerp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/primaERP/jmhz-xml-editor/tree/main/style_guide/.cursor/skills/clarify
Command: npx skills add https://github.com/primaERP/jmhz-xml-editor --skill clarify-primaerp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill helps teams improve unclear, confusing, or poorly written interface text to make products easier to understand and use.

Core Features & Use Cases

  • Identify clarity problems: jargon, ambiguity, passive voice, length, assumptions, missing context, and tone.
  • Plan and implement copy improvements: define primary message, action needed, tone, and constraints; align with product voice.
  • Apply clarity across common areas: error messages, form labels, button text, help text, empty states, success messages, loading states, confirmation dialogs, and navigation.

Quick Start

Provide a UI text block you want improved and ask for a clear rewrite following the guidelines.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I write clear UX copy for error messages and form labels?

Writing clear UX copy involves identifying jargon and ambiguity in interface text, then rewriting error messages and form labels using active voice and consistent terminology to be actionable and easy to understand.

What is UX microcopy and how does it improve interface usability?

UX microcopy is the text within user interfaces, such as button text, navigation, and empty states. Improving microcopy clarity eliminates confusing language, ensuring users can successfully navigate and interact with the product.

How do I rewrite confusing UI text for web and mobile interfaces?

Rewriting confusing UI text requires analyzing interface text blocks for missing context and passive voice, then applying UX writing principles to generate clear, actionable rewrites that align with your product voice.

Can I use this to fix unclear empty states and confirmation dialogs?

Yes, you can fix unclear empty states and confirmation dialogs by providing the UI text block and requesting a rewrite. The process identifies clarity problems and implements copy improvements to make these states clear.

What is the best way to remove jargon from interface text?

The best way to remove jargon from interface text is through iterative refinement that identifies confusing terms, defines the primary message and constraints, and replaces jargon with clear, consistent, and actionable language.

Why should I use UX writing principles for microcopy?

Using UX writing principles for microcopy ensures interface text avoids jargon, uses active voice, provides examples, and explains why, directly improving usability and making product interactions clearer for users.