clarify

Rewrite unclear interface copy and error messages for web and mobile interfaces.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/1toe/spotify-to-ytmusic --skill clarify-1toe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/1toe/spotify-to-ytmusic/tree/main/.cursor/skills/clarify
Command: npx skills add https://github.com/1toe/spotify-to-ytmusic --skill clarify-1toe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear, confusing, or poorly written interface text so users understand what happened and what to do next, reducing frustration and support load.

Core Features & Use Cases

  • Error messages: Rewrite technical or vague errors into plain language that explains the cause and next steps.
  • Form labels & instructions: Clarify labels, placeholders, and helper text to set expectations and reduce input mistakes.
  • Buttons, empty states & confirmations: Make CTAs specific, provide actionable empty states, and surface consequences in confirmations.
  • Use case: Turn an ambiguous error like "Invalid input" into "We couldn't save your address because the postal code looks incomplete — enter a 5-digit ZIP code."

Quick Start

Ask clarify to rewrite the error message "Error 403: Forbidden" into a user-friendly explanation that tells the user why access is blocked and what steps to request access.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite confusing error messages into clear UX copy?

To rewrite confusing error messages into clear UX copy, you transform vague technical text into plain language that explains the issue and specifies actionable next steps. This reduces user frustration by avoiding jargon and blame while ensuring concise, actionable text.

What is the best way to clarify form labels and helper text for web interfaces?

The best way to clarify form labels and helper text is to refine placeholders and instructions so they explicitly set user expectations and reduce input mistakes. This process produces concise text tailored for both web and mobile interfaces while respecting localization constraints.

How do you write actionable empty states and specific CTA buttons?

To write actionable empty states and specific CTA buttons, you craft copy that provides clear next steps and surfaces potential consequences in confirmations. This makes user interfaces easier to understand by guiding users with concise, actionable text rather than ambiguous instructions.

Can I use UX writing techniques to fix technical error messages without losing context?

Yes, you can use UX writing techniques to fix technical error messages without losing context by translating error codes into plain language. The rewritten copy explains the cause of the issue, recommends tone and audience assumptions, and specifies next steps while respecting localization constraints.

Why does my UI copy sound confusing and how can I make it easier to understand?

Your UI copy sounds confusing because it likely contains jargon or blames the user for errors. You can make it easier to understand by rewriting the text to explain the issue directly, specify next steps, and recommend appropriate tone and audience assumptions for your interface.

When do I need to apply UX writing to refine interface text and microcopy?

You need to apply UX writing to refine interface text and microcopy when users struggle to understand what happened or what to do next. Rewriting error messages, form labels, and tooltips into concise, actionable text reduces frustration and lowers support load across web and mobile interfaces.