clarify

Rewrite unclear interface labels, instructions, and error messages.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jkenney47/finance-app-ux-planning-snapshot-20260308-155100 --skill clarify-jkenney47
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/jkenney47/finance-app-ux-planning-snapshot-20260308-155100/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/jkenney47/finance-app-ux-planning-snapshot-20260308-155100 --skill clarify-jkenney47

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses confusing, vague, or unhelpful interface text, ensuring users understand what's happening and what to do next, reducing friction and support load.

Core Features & Use Cases

  • Improve UX Copy: Rewrites unclear labels, instructions, error messages, and microcopy.
  • Contextual Adaptation: Adjusts tone and clarity based on user state (error, success, etc.) and audience.
  • Use Case: A user encounters an error message like "Operation failed. Code 500." This Skill would rewrite it to something like, "We couldn't save your changes because of a temporary server issue. Please try again in a few minutes. If the problem continues, contact support."

Quick Start

Use the clarify skill to improve the error message displayed when a user fails to upload a profile picture.

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 microcopy to be clear and actionable?

To rewrite confusing UX microcopy, target specific features, pages, or routes to refine labels, instructions, and error messages. This process improves user comprehension and actionability by applying principles of clarity, conciseness, and human language.

What is the best way to improve unclear user interface copy for error messages?

The best way to improve unclear user interface copy is to adjust the tone based on the user's emotional state and desired outcomes. Transforming vague errors like "Operation failed" into actionable explanations reduces user friction and support load.

How does contextual adaptation work for UX writing across different user states?

Contextual adaptation in UX writing works by adjusting tone and clarity based on the user state, such as error or success, and the specific audience. This ensures the interface text communicates effectively and reduces confusion during critical interactions.

When do I need to refine messaging for specific application routes?

You need to refine messaging for specific application routes when users encounter vague instructions or labels that prevent them from understanding what to do next. Refining this copy targets the exact feature to improve user comprehension and actionability.

Can I use this approach to fix unhelpful instructions on a specific page?

Yes, you can use this approach to fix unhelpful instructions on a specific page by targeting that route directly. The process enhances unclear labels and microcopy based on the audience and desired outcomes to ensure users understand the required actions.