skills.rest
marpme
marpmeCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

i-clarify

Analyze UI text for jargon, ambiguity, and passive voice, then refine it.

1|Updated Feb 6, 2025
Search Tags:#clarity#microcopy#copywriting#ux writing#user interface#error messages
One-click install
npx skills add https://github.com/marpme/stimmlage --skill i-clarify
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: i-clarify
Source: https://github.com/marpme/stimmlage/tree/main/.claude/skills/i-clarify
Command: npx skills add https://github.com/marpme/stimmlage --skill i-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses confusing, unclear, or poorly written text within user interfaces, making products more understandable and easier to use.

Core Features & Use Cases

  • Clarity Assessment: Identifies jargon, ambiguity, passive voice, and other clarity issues.
  • Copy Improvement: Refines error messages, labels, instructions, and other UI text.
  • Use Case: Improve the confusing error message "Operation failed" to "Your request could not be completed because of a network issue. Please check your connection and try again."

Quick Start

Improve the clarity of the error message "Invalid input" for a user registration form.

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 for better user interface clarity?▼

To improve UX copy clarity, analyze text for jargon, ambiguity, and passive voice, then refine it based on audience, user state, and action to enhance user interface understandability and usability.

What is the best way to rewrite confusing microcopy and form labels?▼

The best way to rewrite confusing microcopy and form labels is to systematically assess the context and user state, replacing vague terms with specific, actionable instructions that guide the user effectively.

How do I write clearer success messages, empty states, and loading states?▼

Writing clearer success messages, empty states, and loading states involves refining the text to match the specific user action and context, ensuring the interface remains understandable during all system processes.

Can I fix passive voice and jargon in my UI text automatically?▼

Yes, you can fix passive voice and jargon in your UI text by systematically identifying clarity issues within the copy and refining the language to be direct and easily understood by the target audience.

Does UX writing clarity assessment work for confirmation dialogs and navigation text?▼

Yes, UX writing clarity assessment works for confirmation dialogs and navigation text, analyzing these elements for ambiguity and context to ensure instructions and actions are clear and usable for the audience.

Related Skills

Explore More Content & Communication Skills→
TraftGTraftG
33

localize

Extracts and validates translation strings from source files into diff-ready tables.

Community
Advanced
alongor666alongor666
1

ai-insights-and-ux-copy

Generate accessibility-aware UX copy and onboarding guidance for healthcare portals.

Community
Advanced
mabdulraufmabdulrauf

microcopy

Standardize CN/EN UI microcopy with fixed terminology and actionable guidance.

Community
Intermediate
ZpankzZpankz
7

writing-assistant

Correct grammar and spelling across languages while preserving author voice.

Community
Intermediate