clarify

Rewrite unclear UX copy into clear, actionable language for interfaces.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams rewrite unclear UX copy into clear, actionable language that reduces confusion and support tickets.

Core Features & Use Cases

  • Clarity auditing: Identify jargon, ambiguity, passive voice, and missing context across UI copy.
  • Copy rewriting: Produce clear, actionable alternatives for labels, error messages, tooltips, and instructions.
  • Consistency & standards: Align copy with design principles and brand voice across products.

Quick Start

Rewrite the provided UI copy to maximize clarity following the guidance in this skill.

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 auditing text for jargon, ambiguity, and passive voice, then replacing it with clear, actionable language that aligns with your brand voice and design principles.

What is the best way to audit UI copy for clarity during a design review?

The best way to audit UI copy for clarity during a design review is to systematically evaluate labels, error messages, and tooltips against established clarity principles to identify missing context and confusing phrasing.

How do I write clear error messages and tooltips for web and mobile interfaces?

Write clear error messages and tooltips for web and mobile interfaces by applying clarity principles to produce direct, actionable rewrite guidance that removes technical jargon and explains exactly what the user needs to do next.

Does UI copy rewriting help reduce support tickets caused by confusing instructions?

Yes, UI copy rewriting helps reduce support tickets by transforming confusing instructions and ambiguous labels into clear, actionable language that users can easily understand without needing additional assistance.

Can I align placeholder text and labels with brand voice and consistency standards?

Yes, you can align placeholder text and labels with brand voice and consistency standards by auditing existing copy and rewriting it to match established design principles while maintaining clarity and usability across products.