skills.rest
Muccarini
MuccariniCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/Muccarini/automata --skill clarify-muccarini
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Design & Creative Skills→
Srujan0798Srujan0798

ux-copy

Generate or audit UX microcopy for CTAs, errors, and onboarding.

Community
Intermediate
42team-ru42team-ru

clarify

Identify unclear interface copy and generate clear, concise rewrites with rationale.

Official
Advanced
TheCardGoatTheCardGoat
14

clarify

Rewrite unclear product interface copy with diagnostics and verification checklists.

Official
Intermediate
EveryIncEveryInc
28

Plus One Brand Voice

Apply the Plus One sub-brand voice framework to content creation and editorial review.

Official
Basic