clarify

Analyze interface text and produce rewrite suggestions with validation notes.

Updated Mar 16, 2026

Search Tags:#clarity #copywriting #usability #interface #ux-writing #ux-copy #copy-improvement

Ready to run

npx skills add https://github.com/Muccarini/automata --skill clarify-muccarini

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/Muccarini/automata/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/Muccarini/automata --skill clarify-muccarini

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

Analyze and identify clarity problems in interface text across onboarding, forms, error messages, labels, buttons, help text, and empty states.
Propose concrete rewrite options and a plan to apply them following established clarity principles.
Create copy-ready snippets and validation notes to guide product teams in iterative improvements.

Quick Start

Ask the AI to rewrite the onboarding error message to be specific, actionable, and empathetic.

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 in my interface?▼

To improve unclear UX copy, you can analyze interface text like onboarding and error messages to identify clarity problems. The Skill provides structured rewrite suggestions, validation notes, and copy-ready snippets following usability best practices.

What is the best way to rewrite error messages for better usability?▼

The best way to rewrite error messages for usability is to make them specific, actionable, and empathetic. This Skill analyzes your existing microcopy and proposes concrete rewrite options to guide users through errors effectively.

How do I make form labels and microcopy easier to understand?▼

Making form labels and microcopy easier to understand requires applying clarity principles across your interface. The Skill identifies problematic help text and labels, then produces structured rewrite suggestions and copy-ready snippets for product teams.

Can I use this to fix empty states and onboarding instructions for web and mobile?▼

Yes, you can fix empty states and onboarding instructions for web and mobile interfaces. The Skill applies clarity principles across both platforms to generate actionable rewrite plans and validation notes for iterative improvements.

Why does my onboarding copy confuse users instead of guiding them?▼

Your onboarding copy likely confuses users due to vague instructions and a lack of actionable microcopy. The Skill analyzes your interface text to pinpoint these clarity problems and suggests specific, user-friendly rewrites.

Are there limitations to improving interface text with UX writing clarity principles?▼

Improving interface text with UX writing clarity principles is limited to text analysis and rewrite suggestions. The Skill provides structured copy-ready snippets and validation notes but does not implement the changes directly into your codebase.