clarify

Rewrite unclear UX copy into precise, user-centered language.

1|2|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/kubermatic/kubelb-dashboard --skill clarify-kubermatic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/kubermatic/kubelb-dashboard/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/kubermatic/kubelb-dashboard --skill clarify-kubermatic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unclear and ambiguous UX copy, error messages, labels, and instructions confuse users, degrade usability, and increase support needs. This skill provides a structured approach to rewrite copy for clarity and user comprehension.

Core Features & Use Cases

  • Audit and identify unclear text across UI, errors, and tooltips.
  • Propose precise rewrites with plain language, active voice, and user-centric tone.
  • Apply the Context Gathering Protocol and design principles to tailor copy for audiences and scenarios.
  • Use Case: A product team faces confusion on a signup form; apply this skill to rewrite error messages and help text to improve comprehension and task completion.

Quick Start

Describe the unclear UI elements and request clear, actionable rewrite suggestions.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite unclear UX copy for better usability?

Rewrite unclear UX copy by applying design principles to produce clear, user-centered text using plain language, active voice, and an audience-appropriate tone. This approach improves comprehension across dashboards, forms, error messages, tooltips, empty states, and onboarding flows.

Why do my error messages confuse users and how can I fix them?

Error messages confuse users when they use ambiguous language instead of precise instructions. Fix them by applying a structured approach to rewrite copy with user-centric tone and active voice, ensuring the text is actionable and clearly explains the required resolution.

What's the best way to audit and fix unclear UI labels and tooltips?

The best way to audit unclear UI labels and tooltips is to identify ambiguous text across the interface and propose precise rewrites. Apply a Context Gathering Protocol to tailor the microcopy for specific audiences and scenarios while adhering to core design principles.

Can I use this approach to improve onboarding flow microcopy?

Yes, you can improve onboarding flow microcopy by auditing the existing text and proposing user-centered rewrites. This ensures instructions and help text use precise language and consistency, which reduces user confusion and increases task completion rates.

When should I rewrite microcopy for consistency and tone?

Rewrite microcopy for consistency and tone when unclear instructions degrade usability or increase support needs. Apply structured rewrites to satisfy requirements for precise language, active voice, and an audience-appropriate tone across all user interface elements.

How do unclear empty states affect user comprehension and task completion?

Unclear empty states confuse users by failing to guide them on available actions. Rewriting this UX copy with plain language and design principles provides clear instructions, directly improving user comprehension and facilitating successful task completion.