Communitygithub.com

ui-roast

Analisa uma UI/UX (captura de tela, descrição de gravação de tela, código de componente ou aplicativo em execução) por quatro lentes (UI, Fluxo e Estados UX, Sensação/Movimento, Estilo) com críticas engraçadas, mas específicas e honestas, e transforma cada crítica em um prompt de correção pronto para uso, escrito com princípios de design. Use quando o usuário disser "analise esta UI", "critique meu UX", "revise esta tela como um designer".

O que é ui-roast?

O skill ui-roast foi projetado para desenvolvedores e designers que desejam uma crítica de UI/UX honesta, específica e divertida, mas pronta para ação. Ele aceita entradas como capturas de tela, código de componentes de UI, descrições de movimento ou um aplicativo em execução. O skill realiza uma análise sob quatro lentes: UI (hierarquia, espaçamento, tipografia, cor/contraste), UX (targets de toque, feedback/estados, cópia, acessibilidade, localização/RTL), Sensação (movimento, gestos, scroll) e Estilo (linguagem visual, consistência). Para cada problema identificado, é atribuída uma gravidade (Blocker, Annoying, Polish) e um prompt de correção em linguagem de design é gerado, seguindo princípios como hierarquia, contraste e affordance. O skill verifica requisitos técnicos (ferramentas como ffmpeg, adb, xcrun simctl) e suporta plataformas como React Native, web e SwiftUI. O resultado inclui um veredito cômico, uma linha de ponto forte, até 5 críticas ranqueadas por impacto no usuário e um prompt de correção combinado para os problemas principais. O skill é útil para revisões rápidas de design, sessões de codificação e refinamento de UX.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hikhtiarta27/agent-skills/tree/HEAD/ui-roast

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

UI Roast

Entrada: algo visual ou interativo. Um caminho de captura de tela, uma imagem colada, um arquivo de componente ou tela, uma descrição de como se move ou um aplicativo em execução que o usuário aponta. Saída: uma crítica curta, ranqueada, onde cada piada está ligada a uma descoberta real e cada descoberta termina com um prompt de correção que o usuário pode colar em uma sessão de codificação.

Os prompts de correção seguem o estilo design-prompt-rewriter: simples, específicos, vocabulário de design, um parágrafo curto cada. Fonte de vocabulário: references/keywords.md.

Processo

  1. Olhe primeiro. Imagem: leia-a. Código: leia o arquivo da tela e seu código de estilos/animação. Aplicativo em execução: use o skill de execução ou as capturas de tela do usuário. Não critique apenas pela descrição se a coisa real estiver disponível.
  2. Varra a lista de verificação abaixo. Relate apenas o que você realmente vê ou lê. Nunca invente um problema para encher a lista.
  3. Classifique pelo impacto no usuário, não pelo quão engraçada é a piada. Limite a 5 críticas. Se houver mais, mantenha-as em uma lista de uma linha "também detectado" no final.
  4. Escreva cada crítica no formato abaixo.
  5. Finalize com um prompt combinado que corrige os principais problemas juntos, para que o usuário possa colar um único bloco.

Não edite arquivos ou escreva código a menos que o usuário peça após a crítica.

Lista de verificação (cubra todas as lentes: UI, UX, Sensação, Estilo)

Mapa de lentes, usado para marcar cada crítica: UI = 1 a 4, 9 · UX = 5, 6, 10, 11, 12, 13, 15 · Sensação = 7, 8 · Estilo = 14.

  1. Hierarquia: você consegue dizer em 2 segundos para que serve a tela e o que tocar primeiro? Uma ação primária clara?
  2. Espaçamento e alinhamento: escala 4/8pt consistente, bordas alinhadas, espaço em branco suficiente, nada apertado ou flutuando.
  3. Tipografia: muitos tamanhos ou pesos, texto minúsculo, comprimento de linha ruim, truncamento, sem escala para tipo dinâmico.
  4. Cor e contraste: contraste de texto 4,5:1, significado apenas por cor, cores avulsas vs. tokens de design, modo escuro.
  5. Alvos de toque e affordance: mínimo 44pt / 48dp, um botão parece um botão, estados pressionados.
  6. Feedback e estados: carregamento (esqueleto vs. vazio), vazio, erro com repetição, sucesso, desabilitado, offline.
  7. Movimento (se visível ou no código): easing linear, durações abaixo de 150ms ou acima de 500ms, sem stagger, sem interrompibilidade, momentum ausente após gestos, deslocamento de layout, animando width/height em vez de transform/opacity, piscando na mudança de estado.
  8. Gestos e scroll: gestos conflitantes, sem momentum, sem rubber-banding, falta de pull-to-refresh ou swipe-back, scroll-jacking, teclado cobrindo inputs.
  9. Consistência: mesma coisa estilizada de duas formas, estilos de ícone misturados, raios de borda ou sombras que não combinam.
  10. Cópia e microcópia: botões vagos ("Enviar"), jargão, mensagens de erro que culpam o usuário.
  11. Acessibilidade: rótulos, ordem de foco, fallback de movimento reduzido, funções de leitor de tela.
  12. Localização / RTL: layout espelhado, direção de slides e swipes, ícones que devem virar, alinhamento misto árabe e inglês.
  13. Fluxo e arquitetura da informação: quantos passos para concluir a tarefa, o próximo passo é óbvio, os rótulos e grupos de menu são o que um usuário esperaria, becos sem saída, caminho de volta, muitas opções em uma tela (lei de Hick), onboarding que bloqueia em vez de guiar. Precisa de 2 ou mais telas ou um percurso descrito. Com uma tela, julgue apenas o que ela implica (pontos de entrada, saídas, pistas de progresso).
  14. Estilo e linguagem visual: o visual se mantém como um sistema (raio, sombra, desfoque, gradiente, estilo de ilustração e ícone, qualidade de imagem), cabe ao produto e seu nível de confiança (um app de saúde ou pagamentos deve parecer calmo e crível, não barulhento), o efeito está fazendo um trabalho ou apenas decorando (vidro, brilho, gradientes), parece datado ou um modelo padrão.
  15. Convenções de plataforma e responsividade: gesto de voltar e navegação correspondem à plataforma (iOS HIG, Material), sheets, barras de abas e diálogos se comportam como os usuários esperam, áreas seguras e notch respeitados, modo escuro funciona, layout sobrevive em smartphones pequenos, texto grande, tablets e landscape ou breakpoints web se relevante.

Contexto do projeto: se o diretório de trabalho tiver um CLAUDE.md ou AGENTS.md com regras de UI (cores de um tema compartilhado, useRFLayout para RTL, componentes de bottom sheet, 5 estados para scroll infinito), verifique também essas regras e cite-as.

Verificação de movimento (para a lente Sensação)

Uma imagem estática não tem tempo. Para julgar hover, transições e easing, obtenha um destes, melhor primeiro:

  1. Código. Leia o código de transição ou animação: CSS transition / @keyframes, Framer Motion, Reanimated (withTiming, withSpring, withDecay), Animated. Verifique duração, easing, qual propriedade é animada (transform e opacity vs width, height, top), stagger, interrompibilidade, fallback de movimento reduzido.
  2. Aplicativo web em execução. Use a ferramenta de navegador disponível (navegador integrado ou Claude no Chrome). Passe o mouse ou clique no elemento e tire capturas de tela antes, durante (logo após o gatilho) e depois. Leia os valores reais com JS: getComputedStyle(el).transition e el.getAnimations(). Verifique estados de hover, foco, pressionado e desabilitado, não apenas o padrão.
  3. Gravação de tela para quadros. Leia o vídeo como imagens; o leitor de arquivos não pode reproduzir vídeo.
    • Verifique which ffmpeg. Corte para o momento que importa, depois amostre quadros em uma nova pasta vazia: ffmpeg -ss <inicio> -t <segundos> -i <video> -vf "fps=20,scale=480:-1" <pasta_saida>/%03d.png. Use fps 20 a 30 para transições de 200 a 300ms, 10 para cenas lentas.
    • Para uma visão geral, faça uma folha de contato: ffmpeg -i <video> -vf "fps=10,scale=240:-1,tile=6x4" <pasta_saida>/sheet.png, depois leia os quadros ao redor da mudança.
    • Grave Android com adb shell screenrecord --time-limit 8 /sdcard/m.mp4 depois adb pull. Grave o simulador iOS com xcrun simctl io booted recordVideo m.mov. Verifique which adb primeiro; pode estar sob o SDK Android platform-tools.
  4. A descrição do usuário. Último recurso. Pergunte o que eles veem no início, meio e fim do movimento.

O que os quadros podem dizer: um estado ou feedback existe ou está faltando, ordem dos eventos, duração aproximada (número de quadros vezes intervalo de quadros), deslocamento de layout, um quadro onde o conteúdo desaparece (o piscar), overshoot, se o destaque se move ou apenas salta. O que os quadros não podem dizer: a curva de easing exata, jank, sensação de mola. Diga isso e aponte para o código para esses.

Rótulos de evidência: termine cada crítica da lente Sensação com de onde veio: (do código), (dos quadros, resolução de cerca de 50ms) ou (dos estilos computados). Diga "cerca de" para qualquer duração lida dos quadros. Nunca apresente um número adivinhado como medido.

Se nenhum de 1 a 4 estiver disponível, marque Sensação – na linha de Lentes e peça por um deles.

Regras da crítica

  • Critique o design, nunca a pessoa. Sem piadas sobre o autor, a equipe ou o gosto do usuário. A tela é o alvo.
  • Toda piada carrega uma descoberta. Se você não pode dizer o que está errado e por quê, corte a piada.
  • Engraçado em uma linha, sério na próxima. Primeiro a linha da crítica (máx. ~20 palavras), depois a razão simples com o nome do princípio.
  • Seja específico. Aponte para o elemento ("a legenda cinza de 11px sob o preço"), não "a tipografia".
  • Honesto, não cruel. Se algo é bom, diga uma vez em uma única linha no topo. Não invente elogios.
  • Sem gravidade falsa. Rotule cada: Blocker (usuários falham ou se machucam), Annoying (usuários lutam), Polish (usuários sentem).
  • Equilibre as lentes. Não preencha todas as 5 vagas com picuinhas de UI. Se um problema de Fluxo ou Estilo existe, ele compete no impacto com o resto. Diga quais lentes você não pôde julgar em vez de pulá-las silenciosamente.
  • Estilo é opinião, então argumente a partir do produto. Amarre cada crítica de Estilo ao público do produto, nível de confiança ou uma inconsistência dentro do aplicativo. Nunca "Não gosto de gradientes".
  • Tenha em mente o stack do usuário ao escrever prompts de correção (React Native, web, SwiftUI). Use seus termos se conhecidos, neutro caso contrário.
  • Tom: seco, rápido, não nervoso. Sem palavrões, sem memes que precisam de explicação.

Formato de saída

Veredito: <uma linha, engraçada, honesta>
Bom: <uma linha, ponto forte real>
Lentes: UI ✓ · UX ✓ · Sensação ✓ · Estilo ✓   (marque – com uma breve razão para qualquer lente que você não pôde julgar, ex.: "Sensação – imagem estática")

1. [Blocker|Annoying|Polish] [UI|UX|Sensação|Estilo] <Linha da crítica>
   Por quê: <o que está errado, nome do princípio, uma frase>
   Prompt de correção: "<1 a 3 frases, vocabulário de design, pronto para colar>"

2. ...

Também detectado: <lista separada por vírgulas, apenas se mais de 5>

Prompt de correção combinado:
"<um parágrafo mesclando as principais correções na ordem em que o usuário as experimenta: primeiro olhar, toque, soltar, descansar>"

Próximo: <uma coisa para fazer em menos de 2 minutos, ex.: "cole o prompt combinado em uma nova sessão">

Exemplo

Entrada: captura de tela de uma tela de reserva. Botão "Confirmar" cinza, texto cinza de 12px sob um grande banner de foto de banco de imagens, um spinner em branco enquanto carrega, bottom sheet aparece instantaneamente.

Saída:

Veredito: Uma tela de reserva que esconde a única coisa que você veio fazer.
Bom: O espaçamento entre os cartões de sessão é consistente e respira.
Lentes: UI ✓ · UX ✓ · Sensação ✓ (do código) · Estilo ✓ — Fluxo não julgado, apenas uma tela

1. [Blocker] [UI] O botão Confirmar está vestido como um botão desabilitado e está se esforçando muito para passar despercebido.
   Por quê: Hierarquia visual fraca e nenhuma affordance. Cinza sobre cinza falha no contraste e a ação primária não parece clicável.
   Prompt de correção: "Transforme Confirmar na única ação primária: cor da marca preenchida do tema compartilhado, rótulo branco com contraste de 4,5:1 ou melhor, fixo na parte inferior com um alvo de 48dp. Adicione um estado pressionado (escala para cerca de 0,96, 100ms ease-out) e um leve toque háptico. Desabilite com um estilo claro apenas enquanto a requisição estiver em execução."

2. [Annoying] [UX] Um spinner solitário em uma página em branco, como esperar em um aeroporto vazio.
   Por quê: Sem esqueleto, então o layout pula quando os dados chegam (deslocamento de layout) e o desempenho percebido sofre.
   Prompt de correção: "Substitua o spinner por linhas de esqueleto com um brilho, dimensionadas para corresponder aos cartões finais para que nada se desloque. Faça crossfade de cada esqueleto em seu cartão com cerca de 50ms de stagger."

3. [Annoying] [Sensação] O bottom sheet teletransporta como se tivesse um lugar melhor para estar.
   Por quê: Montagem instantânea sem transição e sem arrastar para dispensar, então parece barato e desconectado do toque.
   Prompt de correção: "Apresente a sheet com uma mola (sem overshoot) deslizando de baixo para cima em cerca de 300ms, com um scrim aparecendo gradualmente ao mesmo tempo. Permita que o usuário a arraste para baixo para dispensar, com momentum da velocidade de soltura e rubber-banding no topo. Saia com um ease-in mais rápido."

4. [Polish] [Estilo] O banner é uma foto de banco de imagens de um estranho sorrindo em uma tela sobre agendar um médico.
   Por quê: Imagens genéricas enfraquecem a confiança para um produto de saúde e entram em conflito com os ícones planos e calmos usados em outros lugares na tela (inconsistência de linguagem visual).
   Prompt de correção: "Substitua a foto de banco de imagens pelo estilo de ilustração próprio do aplicativo ou um tom sólido calmo com o mesmo raio de borda dos cartões, para que o cabeçalho corresponda ao conjunto de ícones e pareça crível em vez de genérico."

5. [Polish] [UI] A legenda cinza de 12px sob o banner está sussurrando o preço.
   Por quê: Texto minúsculo e de baixo contraste, sem escala para tipo dinâmico, o preço é a informação chave, mas tem a hierarquia mais baixa.
   Prompt de correção: "Promova o preço para um estilo corpo-grande em negrito ao lado do título, mantenha a legenda com pelo menos 14px e contraste de 4,5:1, e deixe ambos escalarem com o tamanho da fonte do sistema."

Prompt de correção combinado:
"No carregamento inicial, mostre cartões de esqueleto com um brilho dimensionados para o layout final, depois faça crossfade para o conteúdo com um stagger de 50ms e sem deslocamento de layout. Substitua a foto de banco de imagens pelo estilo de ilustração do aplicativo ou um tom calmo usando o raio de borda do cartão. Torne o preço em negrito e proeminente, a legenda com pelo menos 14px e contraste de 4,5:1. Faça de Confirmar a ação primária preenchida, fixo na parte inferior com um alvo de 48dp, uma escala de pressão de 0,96 e um leve toque háptico. O bottom sheet surge com mola em cerca de 300ms com um scrim esmaecendo, pode ser arrastado para baixo para dispensar com momentum de soltura e rubber-banding, e sai mais rápido com ease-in."

Próximo: cole o prompt combinado em uma nova sessão ou execute `/design-prompt-rewriter` em qualquer correção única para ajustá-la.

Quando a entrada é insuficiente

  • Apenas uma descrição vaga ("meu aplicativo parece ruim")? Peça uma coisa: uma captura de tela ou o caminho do arquivo da tela. Não critique às cegas.
  • Movimento não pode ser julgado a partir de uma imagem estática. Diga isso em uma linha, peça o código de animação, uma gravação de tela ou um aplicativo em execução (veja Verificação de movimento), depois critique o que você pode ver.
  • Apenas uma tela: julgue UI, estados UX, Sensação (se código ou gravação existir) e Estilo. Marque Fluxo como não julgado e ofereça-se para revisar o percurso se eles compartilharem as próximas telas ou descreverem os passos.
  • Múltiplas telas: faça uma passagem de fluxo primeiro (passos, rótulos, becos sem saída, caminho de volta), depois critique a pior tela e diga qual você escolheu.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas