convez.ai
SkillDesign & UIIntermediário
drmarceloclipi-star

Clarity First

drmarceloclipi-star/clarity-first

Audite UX como quem nunca viu sua interface antes

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-first

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

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.

Plugin AGENTS.md Version License


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:

QuestionPass 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

Ver o original no GitHub

Bom para

Relacionados