clarify

Rewrite interface copy for clarity, specificity, and user guidance.

1|2|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/cinjoff/fhhs-skills --skill clarify-cinjoff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/cinjoff/fhhs-skills/tree/main/.claude/skills/clarify
Command: npx skills add https://github.com/cinjoff/fhhs-skills --skill clarify-cinjoff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill tackles confusing, unclear, or poorly written interface text, ensuring your product's messages are easily understood by users, reducing frustration and errors.

Core Features & Use Cases

  • Error Message Improvement: Transforms cryptic error codes into helpful, actionable advice.
  • Label & Instruction Clarity: Rewrites form labels and instructions for better comprehension.
  • Use Case: A user encounters an error message like "Invalid input." This Skill would rephrase it to something like, "Email addresses need an @ symbol. Try: [email protected]", guiding the user to a solution.

Quick Start

Improve the clarity of the error message "Operation failed due to an unknown reason."

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I improve UX copy for confusing error messages?

Improving UX copy for error messages involves analyzing the audience, context, and user state to refine text for specificity, conciseness, and active voice. This transforms cryptic codes into actionable, human-toned advice that guides users to a solution.

What is the best way to rewrite form labels and microcopy for clarity?

Rewriting form labels and microcopy requires refining the text based on user state, action, and constraints. Applying principles of consistency and helpfulness ensures your user interface text is easily understood, reducing user frustration and input errors.

Does refining user interface text help with usability and comprehension?

Refining user interface text directly improves usability and comprehension by ensuring messages are specific, concise, and helpful. Clear instructions and a human tone reduce user frustration and prevent errors when navigating your product.

How do I make sure my UX writing adheres to active voice and a human tone?

UX writing adheres to active voice and a human tone by analyzing the text against principles of specificity, conciseness, and helpfulness. Refining error messages and instructions based on audience and context ensures the copy remains consistent and user-centric.

Can I use this approach to fix unclear instructions and UI labels?

You can use this approach to fix unclear instructions and UI labels by evaluating the text against user constraints and context. The refinement process ensures your microcopy is actionable, consistent, and tailored to the user's current state.