clarify

Rewrite unclear UX copy using structured rules and templates.

Updated Jan 2, 2026
One-click install
npx skills add https://github.com/tanaka-mambinge/dotfiles --skill clarify-tanaka-mambinge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/tanaka-mambinge/dotfiles/tree/main/ai-configs/skills/impeccable-clarify
Command: npx skills add https://github.com/tanaka-mambinge/dotfiles --skill clarify-tanaka-mambinge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand and use.

Core Features & Use Cases

  • Identify and plan improvements for unclear, confusing copy across UI, forms, and error messages
  • Provide structured rewrite rules and templates for common UI patterns (errors, labels, CTAs, help text, empty states, and success messages)
  • Real-world examples and checklists that teams can adapt for product interfaces and onboarding

Quick Start

Provide rewritten copy for a confusing label or message to be clearer and more actionable.

Frequently Asked Questions about clarify

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

FAQPage Schema
What is UX writing and how does it improve interface usability?

UX writing improves interface usability by rewriting unclear labels, error messages, and microcopy so users understand what to do next. It applies structured rewrite rules to onboarding flows, CTAs, and help text to reduce user confusion and support tickets.

How do I rewrite confusing error messages to make them clear and actionable?

To rewrite confusing error messages, apply structured rewriting rules and templates that replace vague warnings with specific, actionable guidance. This process clarifies what went wrong and tells users exactly how to fix the issue across web and mobile app interfaces.

What's the best way to improve unclear UI copy and labels in onboarding flows?

The best way to improve unclear UI copy and labels in onboarding flows is to assess existing text against structured rewriting rules and apply practical templates. This identifies confusing copy and replaces it with clear, actionable instructions for new users.

Does this UX writing approach work for both web and mobile app microcopy?

Yes, this UX writing approach works for both web and mobile app microcopy. It provides structured rewrite rules and templates for common UI patterns including CTAs, empty states, success messages, and help text that teams can adapt for any product interface.

When should I use structured rewrite templates for UX copy instead of writing from scratch?

Use structured rewrite templates for UX copy when you need consistent, actionable labels, error messages, and help text across an interface. Templates ensure clarity and reduce support tickets by standardizing how onboarding flows and UI patterns address user confusion.

Why does confusing microcopy increase support tickets and how can I fix it?

Confusing microcopy increases support tickets because users cannot understand error messages, labels, or instructions needed to complete tasks. You fix it by applying structured rewrite rules and practical templates that make UI copy clear, actionable, and easy to follow.