clarify

Identify and refine unclear user interface text using UX writing best practices.

2|Updated May 2, 2025
One-click install
npx skills add https://github.com/daltonkyemiller/dot --skill clarify-daltonkyemiller
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/daltonkyemiller/dot/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/daltonkyemiller/dot --skill clarify-daltonkyemiller

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Skill helps users improve the clarity of user interface text, making interfaces easier to understand and more user-friendly.

Core Features & Use Cases

  • Copy Analysis: Identifies unclear, confusing, or poorly written interface text.
  • Context Gathering: Provides guidance on understanding user mental states and action contexts.
  • Copy Improvement: Offers systematic strategies to refine error messages, labels, instructions, and other text.
  • Principles: Adheres to best practices in UX writing for consistency and helpfulness.

Quick Start

To clarify text in your app, invoke the 'clarify' command and follow the instructions to identify and improve unclear areas.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I improve UX writing for unclear error messages?

To improve UX writing for unclear error messages, you analyze the existing interface text to identify confusing areas, gather context on the user's mental state, and refine the copy using best practices for actionability. This ensures your error messages are user-friendly.

What is the best way to optimize microcopy for interface clarity?

Optimizing microcopy for interface clarity involves systematically identifying poorly written labels and instructions, then refining them to align with product design goals. This approach ensures the text is actionable and consistently helpful for the user.

How do I refine instructional messages to make them more user-friendly?

You refine instructional messages by applying systematic copy improvement strategies that evaluate user mental states and action contexts. This process ensures your instructional text is clear, actionable, and aligned with UX writing principles.

Can I use this approach for both app error handling and microcopy optimization?

Yes, you can use this approach for both app error handling and microcopy optimization. The process evaluates all types of user interface text, including error messages and labels, to ensure they meet user-friendly and actionable design standards.

Why does my interface text need context gathering before copy refinement?

Interface text needs context gathering before copy refinement because understanding the user's mental state and action context is essential. This ensures the refined error messages and microcopy accurately address the user's actual situation and needs.

When should I not use automated copy refinement for UX writing?

You should not use automated copy refinement when your interface text requires deep brand-specific tone adjustments or complex legal disclaimers that exceed standard UX writing best practices and systematic instructional message improvement strategies.