clarify

Rewrite unclear UX copy into concise, active, non-blaming interface text.

51|7|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/Oussemasahbeni/spartan-admin-dashboard --skill clarify-oussemasahbeni
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/Oussemasahbeni/spartan-admin-dashboard/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/Oussemasahbeni/spartan-admin-dashboard --skill clarify-oussemasahbeni

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill improves unclear UX copy, such as confusing labels, error messages, microcopy, and instructions, so users understand what’s happening and what to do next.

Core Features & Use Cases

  • Clarity assessment: Detects ambiguity, jargon, passive voice, missing context, tone mismatch, and length issues in interface text.
  • Copy improvement plan: Defines the primary message, required next action, appropriate tone, and constraints like length and brand voice.
  • Targeted rewriting guidance: Produces clearer versions for common UI areas including error messages, form labels/instructions, CTAs, help text, empty states, success messages, loading states, confirmation dialogs, and navigation/wayfinding.

Quick Start

Provide the specific UI text that feels unclear (and where it appears in the product), then ask the Skill to rewrite it for clarity with an improved tone, clearer instructions, and actionable next steps.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite confusing UX copy to make error messages clearer?

To improve unclear UX copy like error messages, you need to identify ambiguity and rewrite the text to be concise, active, and non-blaming. This ensures users understand the issue and know the exact next action to take.

What is the best way to fix ambiguous form labels and microcopy?

Fixing ambiguous form labels and microcopy requires assessing the text for jargon and missing context, then rewriting it with a clear primary message. This makes interface instructions easy to understand and act upon.

How do I write better call to action text for product usability?

Writing better call to action text involves evaluating existing copy for tone mismatch and length issues, defining the required next action, and producing concise, active text that guides users effectively.

Can I improve empty states and loading messages for content clarity?

Yes, you can improve empty states, loading messages, and success messages by applying targeted rewriting guidance. This process replaces vague interface text with actionable, context-rich instructions.

Why do my confirmation dialogs and navigation wayfinding confuse users?

Confirmation dialogs and navigation wayfinding confuse users when the microcopy contains passive voice or lacks context. Rewriting this interface text to be consistent and action-ready resolves the usability issue.