Clarify

Name: Clarify
Author: educlopez

educlopez/ui-craft

99 installs
247 repo stars
Updated August 4, 2026
educlopez/ui-craft

Review UX copy across buttons, errors, empty states, and form hints, critiquing by default and applying edits only on request.

About

A ui-craft lens that audits microcopy against a checklist for button labels, error messages, empty states, and confirmation language. A developer uses it when copy feels vague, generic, or AI-sounding.

Eight-point checklist covering verb+object labels, actionable errors, and sentence case
Returns a Before/After/Why table and applies edits only when the user says apply

Clarify by the numbers

99 all-time installs (skills.sh)
Ranked #1,139 of 1,880 Design & UI/UX skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

npx skills add https://github.com/educlopez/ui-craft --skill clarify

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/educlopez/ui-craft/clarify.svg)](https://skillselion.com/skills/educlopez/ui-craft/clarify)

Installs	99
repo stars	★ 247
Last updated	August 4, 2026
Repository	educlopez/ui-craft ↗

What it does

Review UX copy across buttons, errors, empty states, and form hints, critiquing by default and applying edits only on request.

Files

SKILL.mdMarkdownGitHub ↗

Context: this sub-skill is one lens of the broader ui-craft skill. If the ui-craft skill is also installed, read its SKILL.md first for Discovery + Anti-Slop + Craft Test, then apply the specific lens below.

Clarify the copy in the target the user described. Load the ui-craft skill.

Default mode: critique, not edit. Return the copy diff in a Review Format table. Only apply changes if the user says "apply".

Checklist — walk the UI and flag every instance:

1. Button labels — verb + object. "Send invite" > "Submit". "Delete project" > "Delete". Never "OK", "Submit", "Click here". 2. Errors — inline, specific, actionable. "Email already in use — sign in or use another address." Never "Something went wrong." 3. Empty states — one line explaining why empty + one CTA. "No projects yet. Create your first." not "It's empty here!" 4. Form hints — below the field, persistent, not just validation-triggered. "Must include a number and a symbol" as helper text, not as an error after submit. 5. Confirmation language — past tense, subject-first. "Project deleted." > "Successfully deleted project." 6. Destructive actions — the noun lives in the button. "Delete {projectName}" > "Delete". The dialog confirms; the button commits. 7. Case — sentence case by default. Title Case only for branded product names. Never ALL CAPS (exception: 11-13px category labels, already in SKILL.md). 8. Voice — clear > clever. Active voice. Short sentences. Real words ("cancel" not "discontinue", "start" not "initiate").

Knob-agnostic — clarity is not tunable. Run the full checklist regardless of CRAFT_LEVEL.

References to read: references/copy.md (microcopy voice + patterns), references/accessibility.md (error message expectations for screen readers).

Output format — the Review Format table:

Before	After	Why

Prioritize by impact (errors and destructive actions first, then CTAs, then helper copy). End with a one-paragraph summary of the overall voice shift. If the user says "apply", edit the code and re-print the table with file paths.