Clarity First
drmarceloclipi-star/clarity-first
Audite UX como quem nunca viu sua interface antes
Ver no GitHubSkill que avalia interfaces como um usuário primeiro acesso, identificando pontos de atrito, jargão desnecessário e elementos que causam confusão. Usa abordagem sistemática com perguntas sobre clareza, necessidade, complexidade e simplicidade para gerar recomendações acionáveis (manter, corrigir ou remover).
Instalação
npx convez-ai drmarceloclipi-star/clarity-first1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Revisar fluxos de onboarding de novos usuários
- Identificar jargão e fricção em formulários
- Avaliar clareza visual e hierarquia de elementos
- Otimizar experiência de primeira visita
Veredito

Skill prático e focado que endereça um problema real: viés do criador na avaliação de UX. A abordagem estruturada com quatro perguntas é clara e reproduzível, gerando feedbacks concretos em vez de recomendações vagas. Compatibilidade multi-plataforma (Claude Code, Cursor, Zed, etc.) via AGENTS.md é um diferencial técnico.
README
A tradução para o português deste README ainda está na fila.
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.
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