clarify

Audit and rewrite unclear interface copy for web and mobile apps.

Updated Nov 23, 2025
One-click install
npx skills add https://github.com/JoniSirvio/bookshelfV2 --skill clarify-jonisirvio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/JoniSirvio/bookshelfV2/tree/main/.cursor/skills/clarify
Command: npx skills add https://github.com/JoniSirvio/bookshelfV2 --skill clarify-jonisirvio

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

  • Audits user-facing copy across errors, labels, placeholders, tooltips, and onboarding to improve clarity and tone.
  • Plans and rewrites copy to increase comprehension, reduce ambiguity, and standardize terminology.
  • Use Case: apply clarity improvements during design reviews or content audits to boost task success and user satisfaction.

Quick Start

Ask the AI to rewrite a sample unclear copy into a clear, actionable version.

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 interface?

To improve unclear UX copy, audit existing error messages, form labels, and tooltips, then rewrite them to be precise, actionable, and user-friendly. This process reduces ambiguity and standardizes terminology across web and mobile apps.

What makes error messages and form labels easy for users to understand?

Clear error messages and form labels are precise, actionable, and aligned with a consistent tone. They guide users effectively by reducing ambiguity and standardizing terminology, which directly boosts task success and user satisfaction.

Can I audit onboarding copy and tooltips during a design review?

Yes, you can audit onboarding copy, tooltips, and placeholders during design reviews or content audits. This identifies confusing interface text and allows you to plan rewrites that increase comprehension and standardize terminology.

What is the best way to standardize interface text across web and mobile apps?

The best way to standardize interface text across web and mobile apps is applying a copy-improvement framework. This defines audit criteria, planning steps, and implementation guidelines to ensure tone alignment and measurable clarity.

When should I rewrite microcopy to increase user comprehension?

You should rewrite microcopy to increase user comprehension whenever interface text is ambiguous or poorly written. Rewriting during QA feedback loops or product writing ensures the text is precise, actionable, and user-friendly.

Does improving interface text require a specific content audit framework?

Improving interface text effectively relies on a copy-improvement framework that defines audit criteria, planning steps, and implementation guidelines. This ensures consistency, tone alignment, and measurable clarity across web and mobile apps.