i-clarify

Identify unclear UX copy and propose clear rewrites with rationale.

1|Updated Aug 29, 2023
One-click install
npx skills add https://github.com/alicanerdogan/dotfiles --skill i-clarify-alicanerdogan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: i-clarify
Source: https://github.com/alicanerdogan/dotfiles/tree/main/pi/skills/i-clarify
Command: npx skills add https://github.com/alicanerdogan/dotfiles --skill i-clarify-alicanerdogan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing.

Core Features & Use Cases

  • Identify and document unclear copy across UI elements, errors, labels, and help text.
  • Propose clear rewrites with rationale and concrete examples for real-world scenarios.
  • Apply the Context Gathering Protocol and design principles to ensure context-aware improvements.

Quick Start

Analyze the provided UI copy and propose clear, actionable rewrites for the key screens to improve clarity and user understanding.

Frequently Asked Questions about i-clarify

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

FAQPage Schema
How do I improve unclear UX copy and error messages in my interface?

To improve unclear UX copy, you analyze existing microcopy, error messages, and labels to identify confusing text, then generate clear rewrite suggestions with concrete examples and rationale to reduce user confusion.

What is the best way to rewrite confusing onboarding instructions and form labels?

The best way to rewrite confusing onboarding instructions and form labels is to apply design principles and a context gathering protocol, producing actionable rewrites that ensure context-aware improvements for better usability.

Why does my microcopy cause user confusion and how can I fix it?

Microcopy causes user confusion when labels, help text, or instructions are unclear or easily misinterpreted. You fix it by documenting the unclear text across UI elements and proposing clear, actionable rewrites for key screens.

Can I use this approach to fix bad error messages and hard-to-follow instructions?

Yes, you can use this approach to fix bad error messages and hard-to-follow instructions. It identifies and documents unclear copy across UI elements, errors, and help text, proposing clear rewrites with rationale.

Do I need frontend design principles to clarify UX writing for settings screens?

Yes, clarifying UX writing for settings screens requires applying best practices from frontend design. This ensures the proposed microcopy rewrites are context-aware and follow established usability principles.

What are the limitations of using automated UX writing for usability improvements?

The process targets unclear text in onboarding, forms, and settings screens where users experience confusion. It relies on a context gathering protocol to ensure accurate improvements, meaning it requires sufficient context to produce effective rewrites.