clarify

Rewrite unclear UX copy and microcopy for clarity and usability.

7|1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/derekr/athr --skill clarify-derekr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/derekr/athr/tree/main/.claude/skills/clarify
Command: npx skills add https://github.com/derekr/athr --skill clarify-derekr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing.

Core Features & Use Cases

  • Clear copy audits: identify jargon, ambiguity, passive voice, and unclear instructions across product interfaces.
  • Copy improvement plans: craft concise, actionable rewrites that preserve intent and tone.
  • Use Case: When onboarding users encounter vague prompts, generate clearer alternatives and rationale.

Quick Start

Provide the UX copy you want improved, and I will draft clearer alternatives following best-practices.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I improve unclear UX copy and microcopy for better usability?

To improve unclear UX copy, provide your existing text for error messages, labels, or tooltips to receive rewritten alternatives that enhance clarity and usability. The process identifies jargon and ambiguity, then delivers concise before/after examples with rationale while maintaining your brand voice.

What is the best way to rewrite confusing error messages in an app interface?

The best way to rewrite confusing error messages is to replace technical jargon and passive voice with actionable, user-focused instructions. You receive before/after examples and rationale that maintain accessibility considerations and brand voice across web and app interfaces.

How do I write clearer onboarding prompts for new users?

To write clearer onboarding prompts, supply the vague text currently causing user friction. You get concise rewrites tailored to your interface that preserve the original intent and tone, complete with explanations for why the new microcopy improves usability.

Can I audit my product interface for bad UX writing and unclear labels?

Yes, you can audit your product interface for bad UX writing by submitting your copy for review. The audit identifies passive voice, jargon, and unclear instructions, providing a copy improvement plan with actionable rewrites for labels, placeholders, and tooltips.

Does improving microcopy affect accessibility considerations in web interfaces?

Improving microcopy directly supports accessibility by replacing ambiguous instructions with clear, screen-reader-friendly text. Rewritten labels, error messages, and tooltips are evaluated against accessibility best practices to ensure all users can navigate the interface effectively.

Why should I use a dedicated UX writing tool instead of a general copywriting approach?

A dedicated UX writing tool focuses specifically on interface elements like error messages, placeholders, and tooltips rather than marketing content. It applies usability principles and accessibility considerations to microcopy, ensuring functional clarity that general copywriting approaches may overlook.