clarify

Identify and rewrite unclear interface text across errors, labels, and tooltips.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear, confusing, or poorly written interface text to make products easier to understand and use.

Core Features & Use Cases

  • Identify and rewrite unclear copy across errors, labels, tooltips, onboarding, and instructions.
  • Ensure consistency and adherence to clarity principles across product surfaces.

Quick Start

Rewrite a confusing label or error message to be clearer and more actionable.

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 copy and error messages for better clarity?

To rewrite confusing UX copy, you identify unclear interface text and apply clarity principles to produce actionable rewrites. This process improves error messages, form labels, and tooltips to make products easier to understand and use.

What is the best way to improve onboarding copy and tooltips for users?

Improving onboarding copy requires evaluating existing text against clarity principles and generating structured, actionable rewrites. This ensures instructions remain consistent and easily digestible across diverse product surfaces and audiences.

How do I make interface labels and form instructions clearer?

Making interface labels clearer involves analyzing poorly written text and replacing it with direct, actionable phrasing. You apply structured guidance to rewrite form instructions, ensuring users can navigate products without confusion.

Can I ensure consistency in UX writing across different product surfaces?

Yes, you can ensure consistency in UX writing by applying standardized clarity principles to all interface text. Structured guidance helps maintain a uniform voice across error messages, labels, and onboarding copy throughout the product.

Does rewriting error messages require a specific format or structure?

Rewriting error messages uses a structured format with clearly defined sections and actionable rewrites. This structure provides consistent guidance, enabling rapid improvements to interface text without altering underlying application logic.

When should I review and update my product's interface text?

You should review interface text when users struggle to understand error messages, form labels, or onboarding instructions. Identifying and rewriting poorly written copy at this stage prevents user frustration and improves overall usability.