clarify

Rewrite unclear UX copy and error messages into actionable plain-language text.

42|5|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/kazdenc/builder-skills --skill clarify-kazdenc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/kazdenc/builder-skills/tree/main/.claude/skills/design/refine/clarify
Command: npx skills add https://github.com/kazdenc/builder-skills --skill clarify-kazdenc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the frustration and confusion users experience due to unclear, ambiguous, or poorly written interface text, leading to errors and a poor user experience.

Core Features & Use Cases

  • Error Message Improvement: Rewrites technical or vague error messages into plain language with actionable advice.
  • Label & Instruction Refinement: Clarifies form labels, instructions, and microcopy for better user comprehension.
  • Use Case: A user encounters an error message like "Invalid input." This Skill can transform it into "Email addresses need an @ symbol. Try: name@example.com", guiding the user effectively.

Quick Start

Improve the clarity of the error message "Operation failed" for the user.

Frequently Asked Questions about clarify

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

FAQPage Schema
What is the best way to improve microcopy and form labels for user comprehension?▼

Improving microcopy and form labels requires applying principles of specificity, conciseness, and active voice. This systematic enhancement replaces ambiguous instructions with clear, human-toned text that guides user actions effectively.

How do I make user interface instructions more specific and concise?▼

Make user interface instructions more specific and concise by identifying ambiguity in the text and applying systematic improvements. Focus on active voice, helpfulness, and a human tone to increase actionability across buttons and empty states.

Can I use UX writing principles to fix unclear empty states and buttons?▼

Yes, you can fix unclear empty states and buttons by evaluating the existing copy for comprehension issues. Enhancing these interface elements involves adopting a human tone, ensuring actionability, and maintaining appropriate context for the user.

Why does technical or ambiguous microcopy lead to a poor user experience?▼

Technical or ambiguous microcopy leads to a poor user experience because it causes frustration and confusion when users cannot understand the interface. Unclear text prevents effective task completion and increases the likelihood of input errors.