clarify

Rewrite confusing UI copy into plain-language, actionable text.

142|31|Updated Jul 13, 2017
One-click install
npx skills add https://github.com/microlinkhq/www --skill clarify-microlinkhq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/microlinkhq/www/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/microlinkhq/www --skill clarify-microlinkhq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It improves unclear user-facing interface copy so people can understand what’s happening and what to do next, reducing confusion and errors.

Core Features & Use Cases

  • Error message rewrites: Replace vague or blaming errors with plain-language explanations, fixes, and (when helpful) examples.
  • Form labels, instructions, and help text: Turn generic labels and assumptions into specific, expectation-setting guidance that supports correct input.
  • UX writing across states: Improve buttons, CTAs, empty/loading/success states, confirmation dialogs, and wayfinding for consistent tone and clarity.

Quick Start

Ask the skill to clarify the copy for the target feature by providing the existing text and describing the intended user action and audience context.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite error messages so users understand what went wrong and how to fix it?

Error messages are rewritten by replacing vague or blaming text with plain-language explanations, specific fixes, and helpful examples. This clarifies the system state and guides the user on the exact next step to resolve the issue.

What is the best way to improve form labels and instructions for better user input?

Improving form labels involves turning generic assumptions into specific, expectation-setting guidance. Rewritten help text supports correct input by clearly stating what is needed, reducing user confusion and submission errors.

How do I fix inconsistent tone across UI states like empty, loading, and success messages?

Inconsistent tone is fixed by rewriting buttons, CTAs, empty, loading, and success states for tone consistency. The rewritten UX copy provides clear, plain-language guidance so users understand what is happening and what to do next.

Can I use UX writing to simplify confusing navigation and wayfinding text in my product?

UX writing simplifies navigation and wayfinding by replacing ambiguous text with clear, actionable instructions. The rewritten copy ensures users can easily understand their current location and how to proceed to their destination.

Why does my microcopy use passive voice and how do I make it more actionable?

Microcopy often uses passive voice, creating ambiguity. It is improved by rewriting text to avoid passive voice and jargon, producing plain-language, actionable instructions that clearly direct the user on what to do next.

Does rewriting UI copy work for confirmation dialogs and CTAs?

Rewriting UI copy works for confirmation dialogs and CTAs by ensuring the text is plain-language, tone-appropriate, and avoids blame. It provides clear next-step guidance, helping users confidently proceed with their actions.