clarify

Rewrite unclear interface copy into clear, actionable user-facing text.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/oliverjone01-dev/t1 --skill clarify-oliverjone01-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/oliverjone01-dev/t1/tree/main/.claude/skills/clarify
Command: npx skills add https://github.com/oliverjone01-dev/t1 --skill clarify-oliverjone01-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps turn confusing product text into clear, human, and actionable copy so users can understand what to do without friction.

Core Features & Use Cases

  • Error message rewrites: Replace vague or blame-heavy errors with plain-language explanations and next steps.
  • UI microcopy improvement: Refine labels, buttons, empty states, success messages, loading text, and confirmation dialogs.
  • Consistency and clarity checks: Keep terminology aligned, remove jargon, and make instructions specific enough to guide real users.

Quick Start

Use the clarify skill to rewrite the unclear copy for the target feature in a clearer, more helpful voice.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite vague error messages into clear UX writing?

To rewrite vague error messages into clear UX writing, replace blame-heavy and jargon-filled text with plain-language explanations. Provide specific next steps and use active, human language to guide user comprehension and reduce friction.

What is the best way to write microcopy for empty states and loading text?

Writing microcopy for empty states and loading text requires specific, actionable instructions. Use consistent terminology, avoid vague placeholders, and maintain a helpful voice so users understand the current interface status without confusion.

How do I improve unclear interface copy and form labels?

Improve unclear interface copy and form labels by applying clear, specific, and active language. Remove confusing jargon and align terminology across the product to ensure instructions effectively guide real users through the required tasks.

Can this skill refine UI microcopy for confirmation dialogs and success messages?

Yes, this skill refines UI microcopy for confirmation dialogs and success messages. It transforms confusing product text into actionable copy, ensuring your interface communicates clearly and helps users understand what to do next.

Why does my interface copy still confuse users despite having instructions?

Interface copy confuses users when it contains jargon, blame-heavy phrasing, or vague placeholders. Clarifying instructions by using plain language, active voice, and consistent terminology directly resolves comprehension issues and smooths user friction.