clarify

Identify jargon, ambiguity, and tone issues in UX copy.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.

Core Features & Use Cases

  • Automated copy audit: Identify jargon, ambiguity, tone mismatches, and length issues across UI messages.

  • Structured rewrite templates: Provide improved copy for errors, labels, placeholders, buttons, and help text.

  • Context-aware guidance: Analyze audience, user mindset, and task to tailor copy improvements.

  • Use Case: Rewrite a confusing error message like "Invalid input" to "Please enter a valid email address to continue."

Quick Start

Provide an unclear UI text sample and prompt the skill to generate a clear, user-friendly rewrite following the Context Gathering Protocol.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I improve unclear UX copy in my user interface?

To improve unclear UX copy, audit interface text for jargon, ambiguity, and tone mismatches, then apply structured rewrite templates to generate clear, actionable microcopy for error messages, labels, and placeholders.

How do I audit my UI text for jargon and tone issues?

Audit UI text for jargon and tone issues by evaluating error messages, labels, placeholders, and help text against the target audience's mindset, ensuring all microcopy reduces user friction and remains concise.

Can I use this approach to fix placeholder text and help documentation?

Yes, you can use this approach to fix placeholder text and help documentation by applying structured rewrite templates that analyze the specific task context and user mindset to produce actionable, clear copy recommendations.

What context do I need to provide to get accurate microcopy recommendations?

To get accurate microcopy recommendations, you need to provide context by following a gathering protocol that analyzes the audience, user mindset, and specific task, which allows the skill to tailor copy improvements effectively.

Why does ambiguous interface copy increase user friction?

Ambiguous interface copy increases user friction because it fails to guide users through their current task, causing confusion when error messages, labels, or buttons lack the clarity and actionable tone needed for seamless usability.