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: [email protected]", 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.