clarify

Analyze and rewrite unclear interface text for comprehension and actionability.

5|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/Catsofsuffering/CCGS --skill clarify-catsofsuffering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/Catsofsuffering/CCGS/tree/main/templates/skills/impeccable/clarify
Command: npx skills add https://github.com/Catsofsuffering/CCGS --skill clarify-catsofsuffering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unclear or poorly written interface text causes user confusion, errors, and increased support load by failing to explain actions, consequences, or next steps. This Skill identifies clarity problems in labels, error messages, CTAs, help text, and microcopy, and produces concise, actionable rewrites that match audience needs and context.

Core Features & Use Cases

  • Clarity analysis: Detects jargon, ambiguity, passive voice, missing context, and tone mismatches.
  • Actionable rewrites: Provides specific label, button, tooltip, and error-message rewrites with suggested examples and format guidance.
  • Validation guidance: Checks for comprehension, actionability, brevity, and consistency across screens.
  • Use case: Convert a vague error like "Invalid input" into a clear, empathetic message that explains the problem and next steps for novice users.

Quick Start

Ask the clarify skill to rewrite the error message "Invalid input" into a clear, actionable, and empathetic prompt for a non-technical user.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite error messages for better UX clarity?

To rewrite error messages for better UX clarity, replace vague text like "Invalid input" with concise, actionable explanations that guide users on next steps. Analyzing for jargon, ambiguity, and tone mismatches ensures the rewritten microcopy reduces user friction effectively.

What is UX microcopy and how does it affect usability?

UX microcopy is the small interface text in labels, buttons, tooltips, and empty states that guides user actions. Poorly written microcopy causes confusion and increased support load by failing to explain consequences, while clear text improves usability and task completion.

How do I fix confusing form labels and button text?

Fix confusing form labels and button text by analyzing the existing copy for passive voice and missing context, then applying actionable rewrites that match audience needs. Formatting recommendations and consistency checks ensure the new labels improve comprehension across screens.

Can I use this to improve empty and loading states in web interfaces?

Yes, you can improve empty and loading states in web interfaces by applying clarity analysis to the existing microcopy. The process detects tone mismatches and provides specific rewrites that explain the current context and next steps for novice users.

What is the best way to align UI text tone with audience needs?

The best way to align UI text tone with audience needs is to evaluate the current copy against the target user's technical level, then apply actionable rewrites that adjust empathy and clarity. Validation checks confirm the adjusted tone improves actionability without losing brevity.