clarify

Rewrite unclear UI copy with structured clarity principles and rationale.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/luisartola/findes --skill clarify-luisartola
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/luisartola/findes/tree/main/.github/skills/clarify
Command: npx skills add https://github.com/luisartola/findes --skill clarify-luisartola

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

  • Clear copy identification: Detect jargon, ambiguity, passive voice, insufficient context, and tone mismatches in UI text.
  • Structured rewrite plans: Propose a primary message, next steps, tone, and constraints to guide copy changes.
  • Systematic improvements: Apply clarity principles to errors, form labels, tooltips, empty states, and success messages, with concrete examples.
  • Practical example: Rework a confusing onboarding screen to reduce user friction and support requests.

Quick Start

Provide a clear rewrite of the current UI copy on this screen following the clarity principles.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I fix confusing error messages and UI labels in my app?

Fix confusing error messages and UI labels by detecting jargon, ambiguity, and passive voice, then applying structured rewrite plans that generate clear microcopy, next steps, and rationale to improve interface clarity.

What is the best way to improve onboarding flow copy to reduce user friction?

The best way to improve onboarding flow copy is to gather screen context and systematically apply frontend-design clarity principles, producing concrete text changes that reduce user friction and support requests.

How do I rewrite tooltips and empty states for better UX writing?

Rewrite tooltips and empty states for better UX writing by identifying tone mismatches and insufficient context, then generating concrete copy improvements with examples that guide users through the interface.

Does this UI copy improvement approach work for both web and app screens?

Yes, this UI copy improvement approach works for both web and app screens, applying clarity principles across onboarding flows, error messages, labels, tooltips, and help text without platform-specific constraints.

How do I identify unclear interface text that needs copy improvements?

Identify unclear interface text by checking for jargon, ambiguity, passive voice, insufficient context, and tone mismatches in your UI copy, which signals where structured rewrites are needed.

Why does my microcopy cause user confusion despite clear design?

Your microcopy may cause confusion due to jargon, ambiguity, or tone mismatches in the UI text, requiring a structured rewrite plan that provides a primary message, next steps, and clear constraints.