clarify

Rewrite unclear product interface copy with diagnostics and verification checklists.

14|5|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/TheCardGoat/lorcana-simulator --skill clarify-thecardgoat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/TheCardGoat/lorcana-simulator/tree/main/.agents/skills/clarify
Command: npx skills add https://github.com/TheCardGoat/lorcana-simulator --skill clarify-thecardgoat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It improves confusing or poorly written interface text so users understand what’s happening and what to do next, reducing mistakes, frustration, and support needs.

Core Features & Use Cases

  • Clarity audits for UX copy: Detects issues like jargon, ambiguity, passive voice, missing context, and tone mismatches.
  • Targeted rewrites across UI surfaces: Upgrades error messages, form labels/instructions, CTAs, help text/tooltips, empty states, success/loading messages, and confirmation dialogs.
  • Consistent, actionable UX writing: Applies clear writing principles (specific, concise, active voice) and verifies improvements for comprehension, actionability, brevity, consistency, and tone.
  • Use case: When a simulator feature or bot automation UI shows vague prompts or error text, use this skill to rewrite the copy so players and developers can understand and act correctly.

Quick Start

Ask an AI assistant to run the clarify workflow to rewrite the specific unclear interface text and provide improved replacement copy.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I rewrite unclear UI copy and error messages for better user comprehension?

To rewrite unclear UI copy, you diagnose text for jargon and passive voice, then apply active voice and brevity principles to generate actionable replacement text for error messages and forms. This reduces user frustration and support needs.

What is UX writing clarity audit and how does it improve interface text?

A UX writing clarity audit detects interface text issues like ambiguity, missing context, and tone mismatches. It improves interface text by systematically rewriting prompts and instructions so users understand what is happening and what to do next.

How do I write actionable UX copy for empty states and loading messages?

To write actionable UX copy for empty states and loading messages, apply clear writing principles that are specific and concise. You verify the rewritten copy against a checklist for comprehension, actionability, brevity, consistency, and tone.

Can I use this to fix confusing confirmation dialogs and form labels for first-time users?

Yes, you can fix confusing confirmation dialogs and form labels for first-time users. It targets stressed users by upgrading instructions and help text with consistent, actionable UX writing principles to ensure correct next-step action.

What is the best way to resolve vague prompts in a bot automation UI?

The best way to resolve vague prompts in a bot automation UI is to run a systematic diagnostic workflow. This generates an improvement plan and rewritten UI copy principles, ensuring developers and players understand and act correctly.