clarify

Rewrite unclear interface text into concise, actionable UX copy.

59|14|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/vobase/vobase --skill clarify-vobase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/vobase/vobase/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/vobase/vobase --skill clarify-vobase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interfaces often use unclear, jargon-heavy, or ambiguous text that confuses users, increases support load, and reduces task completion rates. This Skill identifies unclear UX copy — error messages, labels, buttons, tooltips, and instructions — and offers concise, user-centered rewrites that explain actions and next steps.

Core Features & Use Cases

  • Assess clarity: Diagnose issues like jargon, ambiguity, passive voice, missing context, and tone mismatch.
  • Rewrite copy: Produce concise, actionable alternatives for error messages, form labels, CTAs, empty states, and confirmation dialogs.
  • Guided strategy: Define the primary message, required user action, tone, and constraints (length, localization) before editing.
  • Use Case: During a UX review, convert vague error text and generic CTAs into specific, empathetic messages that tell users what happened and how to fix it.

Quick Start

Ask the clarify skill to rewrite the error message "Invalid input" on the signup form to explain what's wrong and how to fix it.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite unclear interface copy and microcopy for better usability?

To rewrite unclear interface copy, you need to diagnose issues like jargon, ambiguity, and passive voice, then replace them with concise, actionable alternatives. This improves UX writing by ensuring error messages, labels, and CTAs explain actions and next steps clearly.

What is the best way to fix vague error messages in web and mobile interfaces?

The best way to fix vague error messages is to convert generic text into specific, empathetic messages that tell users what happened and how to fix it. Effective content design requires defining the primary message, required action, and tone before editing.

How do I improve UX writing for empty states and confirmation dialogs?

Improving UX writing for empty states and confirmation dialogs involves assessing text for missing context and tone mismatch. You then produce concise, user-centered rewrites that guide users with specific instructions on what to do next.

What context do I need to provide for a UX copy clarity review?

For a UX copy clarity review, you must provide context about your audience, user goals, tone, and constraints like length or localization. This background ensures the rewritten microcopy aligns with usability requirements and produces actionable replacements.

Why does jargon-heavy microcopy increase support load and reduce task completion?

Jargon-heavy microcopy increases support load and reduces task completion because it confuses users with ambiguous text and missing context. Rewriting interface copy to be clear and actionable directly addresses these usability issues.