clarify

Identify and correct jargon, ambiguity, passive voice, and missing context in user interface text.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/indroputranto/docling-fleet --skill clarify-indroputranto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/indroputranto/docling-fleet/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/indroputranto/docling-fleet --skill clarify-indroputranto

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses unclear, confusing, or poorly written interface text, making products easier to understand and use.

Core Features & Use Cases

  • Clarity Improvement: Refine text for better UX writing, error messages, microcopy, labels, and instructions.
  • Assessment: Identify clarity problems and understand the context of the text.
  • Planning: Create a strategy for clearer communication with primary messages, actions, and tone.
  • Improvement: Refine text systematically across error messages, form labels, buttons, help text, empty states, success messages, loading states, confirmation dialogs, navigation, and wayfinding.
  • Verification: Test comprehension, actionability, brevity, consistency, and tone.
  • Use Case: When a user reports confusing text or error messages in an application, use this Skill to analyze and improve the copy.

Quick Start

Use the clarify skill to analyze and improve the error message "Error 403: Forbidden" in your application.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I improve clarity in UX writing for confusing interface text?

This skill improves clarity in UX writing by identifying and correcting jargon, ambiguity, passive voice, length, assumptions, and missing context in interface text. It analyzes context and user mental state to provide meaningful improvements.

What is the best way to rewrite unclear error messages for better user understanding?

The best way to rewrite unclear error messages is to systematically assess clarity problems, plan a communication strategy with primary messages, and refine the text to ensure comprehension, actionability, brevity, and consistent tone.

How do I fix ambiguous microcopy and form labels in my application?

You fix ambiguous microcopy and form labels by systematically refining interface text across empty states, loading states, and navigation. This process tests comprehension, actionability, brevity, consistency, and tone to ensure clear communication.

Does this approach work for refining empty states, success messages, and confirmation dialogs?

Yes, this approach works for refining empty states, success messages, loading states, confirmation dialogs, and wayfinding. It systematically improves text across all interface elements to ensure comprehension, actionability, brevity, and consistent tone.

Why do my app users find the interface text and instructions confusing?

Users find interface text confusing due to jargon, ambiguity, passive voice, excessive length, unstated assumptions, and missing context. Analyzing the user's mental state helps identify these specific clarity problems in your microcopy.