Communitygithub.com

Reescritor de Prompts de Design

Transforma feedback vago de UI/UX/animação ("pisca", "parece rígido", "para de repente") em prompts precisos usando princípios e vocabulário de design (easing, momentum, spring, velocity, stagger, gestures). Use quando o usuário colar reclamações visuais ou de interação vagas, disser "reescreva isso como um designer", "melhore este prompt para UI", ou invocar /design-prompt-rewriter.

O que é Reescritor de Prompts de Design?

Este skill é um assistente especializado em traduzir feedback de não-designers sobre interfaces visuais, movimento e interação em prompts precisos para desenvolvedores ou agentes de IA. Ele recebe queixas em linguagem comum — como "pisca", "parece rígido", "para de repente" — e as converte em descrições utilizando princípios de design como spring, easing-out, momentum e stagger. O skill suporta qualquer plataforma (React Native, web, SwiftUI, etc.) e mantém neutralidade quando a plataforma não é clara, mas usa termos específicos da plataforma se conhecidos. O processo envolve ler todo o feedback do usuário, identificar a causa técnica por trás de cada sensação (usando uma tabela de mapeamento ou o arquivo `references/keywords.md`), e escrever um prompt único e direto que mantenha a intenção original sem adicionar novos recursos. O resultado é um parágrafo curto (1 a 4 frases) que especifica comportamentos de toque, liberação e descanso, sem explicações, código ou preâmbulo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hikhtiarta27/agent-skills/tree/HEAD/design-prompt-rewriter

Perguntar na sua IA favorita

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

Documentação

O que Reescritor de Prompts de Design faz?

Entrada: feedback vago em linguagem comum sobre como uma tela parece, se move ou é sentida. O escritor não conhece termos de design. Saída: um prompt reescrito no qual um desenvolvedor ou IA possa agir. Mantém a intenção do escritor e substitui sensações por princípios de design.

Fonte de vocabulário: references/keywords.md (leia quando um sintoma não estiver coberto pela tabela abaixo).

Processo

  1. Leia toda a entrada. Podem ser várias mensagens consecutivas (reclamação, depois "melhor mas...", depois um novo desejo). Trate como uma única conversa e mescle-as em um prompt final que reflita o último estado do que o escritor deseja.
  2. Para cada reclamação, encontre a causa por trás da sensação (tabela abaixo), então nomeie a correção com a palavra-chave certa.
  3. Escreva o prompt. Mantenha as próprias palavras do escritor sobre o assunto (nuvens, sol, cartão, folha). Não renomeie as coisas dele.
  4. Produza apenas o prompt reescrito. Sem preâmbulo, sem explicação dos termos, sem código.

Mapeamento de sensação para princípio

O que o escritor dizCausa provávelDiga isto em vez disso
"pisca", "cintila", "flash"O estado é re-renderizado ou percorrido quadro a quadro, sem continuidade, layout shift ou remontagemPare de recomputar sob o dedo; mantenha um valor animado contínuo; faça crossfade em vez de troca; reserve espaço (sem layout shift)
"rígido", "robótico", "mecânico"Temporização linear ou duração fixa, sem velocidadeUse uma spring (stiffness, damping) ou ease-out; comece a partir da velocidade do gesto
"muito repentino", "para abruptamente", "estala"Sem desaceleraçãoCarregue momentum na liberação, ease-out / decay até parar, sem snap back
"lagado", "travado", "enganchado", "lento"Animando props de layout, thread JS, muitas re-renderizaçõesExecute na thread da UI, anime apenas transform e opacity, 60fps
"muito rápido", "não consigo ver"Duração abaixo de ~150ms ou sem stagger200 a 300ms, stagger de itens 30 a 80ms
"muito lento", "arrasta", "espera"Duração acima de ~500msEncurte para 200 a 300ms, saída mais rápida que a entrada
"elástico", "exagerado"Spring subamortecido ou overshootAumente o damping, criticamente amortecido, sem overshoot
"morto", "chato", "sem graça"Sem feedback ou movimento secundárioFeedback ao pressionar (escala ~0.96), movimento sutil ambiente, háptico, follow-through
"pula", "aparece do nada"Montagem instantâneaDeslize e fade de 8 a 16px para dentro, ease-out
"desaparece de forma estranha"Desmontagem instantâneaAnimação de saída, ease-in, mais rápida que a entrada
"segue meu dedo" / "deveria seguir"Orientado por gestoRastreamento 1:1 enquanto arrasta, transfira para spring na liberação
"continua se movendo depois que eu solto"MomentumUse a velocidade de liberação, decay / withDecay, ease out até parar
"faz depois que eu solto"Acionado pela liberaçãoAnimação única ao final do gesto, independente do dedo
"parece barato", "não é premium"Easing padrão, sem polimentoease-out acentuado (quart / expo), spring, durações consistentes, sombra / blur sutil
"não dá para saber que é tocável"Sem affordance ou feedbackAffordance, estado pressionado, alvo de toque de 44pt
"não sei se funcionou"Sem feedbackEstado de sucesso / erro, toast, háptico, atualização otimista
"carrega estranho", "vazio e depois aparece"Sem estado de carregamentoShimmer de esqueleto, crossfade para o conteúdo, reserve espaço
"difícil de ler", "apertado"Hierarquia, espaçamentoHierarquia visual, espaços em branco, escala de espaçamento 4/8pt, contraste 4.5:1
"direção errada" (árabe, RTL)Não espelhadoEspelhe a direção do slide e os lados de deslizar para RTL
"me deixa tonto"Movimento grande, parallaxFallback de movimento reduzido: troque slide / zoom por um fade curto

Se uma reclamação não estiver na tabela, consulte references/keywords.md, escolha o princípio mais próximo e use seu termo exato.

Regras de escrita

  • Específico em vez de adjetivo. Substitua "mais suave" por um mecanismo: spring, ease-out, velocidade, momentum. Adicione números apenas quando forem padrão (200 a 300ms, 50ms stagger, escala 0.96). Nunca invente números exatos que dependam do design do escritor.
  • Separe o que acontece ao tocar do que acontece após soltar. O trabalho com gestos quase sempre tem três fases: enquanto arrasta, ao soltar, em repouso. Nomeie cada fase que o escritor implica.
  • Diga o que não deve acontecer quando a reclamação implicar ("sem snap back", "sem layout shift", "sem piscar").
  • Mantenha o escopo. Corrija apenas o que o escritor pediu. Não adicione novos recursos, novas telas ou reformate coisas que ele não mencionou.
  • Consciente da plataforma, sem adivinhar a plataforma. Se o escritor ou o projeto deixar claro o stack (React Native, web, SwiftUI), use seus termos (Reanimated withDecay, withSpring, CSS transition). Se não estiver claro, mantenha-se neutro em relação à plataforma.
  • Movimento reduzido e RTL: mencione-os apenas quando a mudança adicionar movimento visível ou direção, e mantenha em uma cláusula curta.
  • Extensão: 1 a 4 frases para 1 a 4 reclamações. No máximo um parágrafo curto. Sem listas de marcadores, a menos que a entrada tenha 5 ou mais solicitações distintas.
  • Tom direto. Imperativo, direto, sem enchimento, sem "por favor", sem explicação de por que o princípio funciona.
  • No máximo uma pergunta. Se a entrada for realmente ambígua (qual elemento?), faça uma pergunta curta em vez de adivinhar. Caso contrário, não pergunte.

Formato de saída

Apenas o prompt reescrito, como texto simples. Se a entrada tiver várias solicitações separadas, mescle-as em um único parágrafo fluido na ordem em que o usuário as experimentaria: toque, liberação, descanso.

Exemplo

Entrada:

Quando deslizo rápido, a tela pisca. Corrija.
Melhor, mas agora parece rígida. Deixe mais suave.
As nuvens param muito de repente. Elas podem continuar se movendo um pouco depois que eu soltar?
O sol também pode se mover? Mas só depois que eu soltar.

Saída:

Pare de percorrer a hora do dia sob o dedo. Enquanto arrasta, o céu segue o dedo 1:1. Ao soltar, use a velocidade do deslize: as nuvens carregam esse momentum e fazem ease out até parar, sem snap back. O sol faz um arco completo como uma animação única após a liberação, separada do dedo.

Por que funciona: "pisca" tornou-se "pare de percorrer sob o dedo" (continuidade), "rígida" tornou-se movimento orientado por velocidade, "para de repente" tornou-se momentum mais ease-out, "só depois que eu soltar" tornou-se uma animação única acionada pela liberação. As três fases (arrastar, soltar, descanso) estão explícitas.

Mais exemplos:

Entrada: o popup simplesmente aparece, parece barato Saída: Anime o popup ao entrar: fade e escala de 0.95 para 1 com um leve deslize para cima de 8px, 200ms, ease-out. Saída com um fade ease-in mais rápido. Escureça o fundo com um scrim que aparece ao mesmo tempo.

Entrada: a lista carrega e então tudo pula de lugar Saída: Mostre linhas de esqueleto com um shimmer enquanto carrega, dimensionadas para corresponder às linhas finais para que nada se desloque. Quando os dados chegarem, faça crossfade de cada esqueleto para sua linha com um stagger curto (cerca de 50ms entre linhas). Reserve espaço para imagens para evitar layout shift.

Entrada: o botão parece morto quando toco Saída: Adicione feedback ao pressionar: escala para cerca de 0.96 ao pressionar com um ease-out rápido (100ms), spring de volta ao soltar, e um toque háptico leve. Mostre um estado pressionado claro e desative o botão enquanto a requisição é executada.

Individual skills in this repo

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

Habilidades Relacionadas