Stats
Actions
Available In
Tags
Plugin
clarity-first
First-Time User Experience lens for UI review and design decisions. Evaluates every screen as if seeing the app for the first time.
README
clarity-first
Review your UI as a stranger seeing it for the first time.
An agent skill that catches every assumption, every friction point, every moment a new user would stop and think.
Runs in Claude Code, Codex CLI, Cursor, Zed, Windsurf, and Gemini CLI — anything that reads the AGENTS.md standard.
The problem
You built something great. But you can't unsee what you know.
Every label that "makes sense", every flow that "feels natural" — it only feels that way because you built it. First-time users don't have your context. And they won't ask. They'll just leave.
The fix
clarity-first applies a First-Time User Experience (FTUE) lens to every screen review. It asks the questions you've stopped asking.
See it work
Point it at a screen. It scans every element, then verdicts each one:
> Review my signup screen with clarity-first
Auditing signup screen as a first-time user…
Element Verdict Why
─────────────────────────────────────────────────────────
Logo + tagline keep Orients instantly
"Sync your workspace" cut Jargon. New user has no workspace yet
8-field form redesign Form wall before any value delivered
"Continue" (gray) fix Primary action not visually dominant
Cookie banner defer Hides the one thing that matters
Golden rule failed: a first-time user stops to think at field 3.
Suggested: email-only first step, defer the rest. 8 fields → 1.
That's the whole point — it returns what to cut, fix, or keep, not vague advice.
Install
Claude Code:
/plugin marketplace add drmarceloclipi-star/clarity-first
/plugin install clarity-first@clarity-first
Restart Claude Code. Done.
Codex CLI · Cursor · Zed · Windsurf · Gemini CLI: grab the portable entrypoint files — no plugin system needed:
curl -fsSLO https://raw.githubusercontent.com/drmarceloclipi-star/clarity-first/main/AGENTS.md
curl -fsSLO https://raw.githubusercontent.com/drmarceloclipi-star/clarity-first/main/GEMINI.md
Drop in your project root, or in ~/.codex/ / ~/.gemini/ to enable it everywhere. Any agent that reads the open AGENTS.md standard picks it up automatically.
Prefer Cargo? (Claude Code)
Symlinks the skill into ~/.claude/skills:
cargo install --git https://github.com/drmarceloclipi-star/clarity-first
clarity-first
Re-run clarity-first anytime to pull the latest.
How it works
Every element on every screen is tested against four questions:
| Question | Pass condition |
|---|---|
| Understand instantly? | No reading, thinking, or scanning required |
| Need this now? | First-time user needs this element on first visit |
| Too much? | Removing half would hurt the experience |
| Simpler possible? | No version exists with fewer steps, words, or choices |
One "no / yes / yes / yes" → redesign.
Trigger
Mention any of these in your prompt and the skill activates:
clarity-first · FTUE · first-time user · onboarding · UX review · simplify UI
The golden rule
If a first-time user stops to think, the design is not finished.
Update
/plugin update clarity-first@clarity-first
Cargo users: re-run clarity-first.
License
MIT
Built by 
Dr. Marcelo Cavalcanti
Stats
Version0.1.0
LanguageRust
Stars0
MaintenanceExcellent
LicenseMIT
Last Commit
Added
Available In
Tags
Categories
