Communitygithub.com

do-design

Design e redesenho de UI e visual contra um DESIGN.md vinculante, com scripts para tudo mensurável. Use para projetar ou reformular páginas e componentes, revisar mudanças de UI, auditar e pontuar uma UI, redesenhar um site, pesquisar um mercado antes de projetar, propor uma direção ousada ou instalar um guardrail de design em um repositório. Comandos: do-audit, do-design-new, do-design-review, do-design-renew, do-crazy.

O que é do-design?

do-design é uma skill para agentes de IA (como Claude Code, Cursor, Codex) que impõe disciplina de design baseada em evidências, com foco em uma especificação central (DESIGN.md). Ela fornece um conjunto de comandos (do-audit, do-design-new, do-design-review, do-design-renew, do-crazy) e scripts Python que automatizam auditorias de UI, verificações de conformidade com o DESIGN.md, análise de contraste (WCAG), escaneamento de código para desvios de tokens, e até mesmo renderização de páginas para inspeção visual. A skill é projetada para projetos com uma especificação de design vinculante (DESIGN.md) e opera em diferentes modos (Persuadir, Operar, Ler, Experiencia) que definem o nível de afastamento da convenção. Ela enfatiza a execução de scripts para obter medições concretas antes de raciocinar sobre um design, evitando suposições não verificadas. Inclui também a capacidade de instalar guardrails em repositórios, adicionando verificadores automatizados. Em vez de confiar apenas na interpretação visual cara (screenshots), a skill prioriza saídas de scripts leves, recorrendo a capturas de tela apenas para julgamentos visuais inevitáveis (hierarquia, distinção).

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diononline-un/design-skill/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

O que do-design faz?

Os caminhos são relativos à pasta desta skill; P é a raiz do projeto. Os scripts são stdlib Python 3.8+. Execute o script antes de raciocinar sobre qualquer coisa que ele meça, cite sua saída e nunca rederive ou estime o que ele relata.

Modelo

  1. O DESIGN.md do projeto (o documento) é vinculante e prevalece sobre esta skill. Em caso de conflito, o documento vence; diga isso.
  2. Toda regra tem sua razão. Uma regra sem razão é excluída na primeira vez que for inconveniente.
  3. Evidência antes dos padrões. Um briefing resumido ("faça algo novo" + um logotipo) é motivo para pesquisar, não para recorrer à aparência usual ou inventar fatos. Sem fonte, sem afirmação: marque a lacuna ou pergunte.
  4. Carregue preguiçosamente. Apenas os arquivos que a tabela de comandos nomeia. Camadas extras "para completude" são uma falha de método.
  5. Convenção é o padrão, não a falha. O modo decide o quão longe se desviar.

Modos: declare uma linha no início de cada comando

ModoO visitante estáImpulso
Persuadirdecidindo e agindoforte: um template é uma falha
Operarcompletando uma tarefacontenção: a convenção é um recurso
Lerentendendo algomédio: o conforto da leitura vence
Experienciadentro do trabalho em siforte: o artefato lidera

Escolha pela superfície, não pelo produto: uma página de destino de uma ferramenta de desenvolvedor é Persuadir, sua tela de configurações é Operar.

Comandos: carregue um arquivo de comando, mais o que suas linhas nomeiam

ComandoQuando usarTambém carregarRisco
do-design-review"isso corresponde ao documento?" Mais barato, execute na maioria das vezeso DESIGN.md do projeto-
do-audit"quão bom é isso?" Pontuação + descobertas classificadasreferences/critique-rubric.md, references/slop-catalog.md, camadas 00-05 que o escopo toca-
do-design-new"construa X": convencional, competente, dentro do documentolayers/00, as 1-3 camadas que a tarefa toca; layers/06 quando o briefing é resumido ou voltado ao clientebaixo
do-design-renew"refaça esta aparência": novo mundo, mesma verdade do produtolayers/00, layers/06médio
do-crazy"algo que ninguém neste setor faria"layers/00, layers/06alto, por design

Camadas: 00-craft-floor (todo modo) · 01-color · 02-typography · 03-space-layout · 04-motion-states · 05-voice · 06-research. Escrevendo um documento: templates/DESIGN.md, examples/01-two-papers.md, references/interview.md.

Scripts (todos aceitam --json)

ExecuteRetorna
scripts/check-design.py --root Pdesvio do bloco de tokens do documento. Saída 0 limpo, 1 desvio, 2 sem documento/tokens. --init rascunha tokens a partir do código
scripts/audit.py scan Pindicações de fonte (IDs como no catálogo de falhas), lacunas de a11y e superfície do navegador, inventário de valor
scripts/audit.py copy Pindicações de prosa e microcópia, ritmo de frase, marcadores de lacuna não preenchidos
scripts/audit.py contrast FG BG / --paper P/DESIGN.mdtaxas WCAG
scripts/audit.py score H L S C T U Dpontuação ponderada, faixa, lista de trabalho
scripts/render-audit.py URL-ou-arquivo [--shots DIR] [--inject-css ARQUIVO]a página renderizada em 1280/768/390: sobreposição, rolagem lateral, clipping, contraste pintado, alvos de toque, visibilidade de foco. --inject-css mede uma correção CSS contra a página implantada antes de implantar. Precisa de Chrome/Chromium
`scripts/research.py suggestprofile
bash scripts/install-guardrails.sh PDESIGN.md a partir do template, o bloco AGENTS.md/CLAUDE.md, o verificador

Capturas de tela custam muito mais contexto do que a saída do script: tire-as apenas para o que precisa de olhos (hierarquia, distinção, composição), apenas na viewport, 390 primeiro. Scripts também podem estar errados: antes de relatar um P0 que pareça improvável, confirme uma vez (uma captura de tela direcionada ou a geometria do elemento) e corrija o script se for um falso positivo.

Definições compartilhadas

Teste de troca. Substitua o nome do produto pelo de um concorrente. Se nada quebrar, a página não diz nada sobre este produto: não escolhido, não feio. Corrija na cópia, no visual e em um detalhe de assinatura, nunca adicionando decoração.

Direção, cinco linhas. Escrito antes de construir, mostrado, depois aguarde um sim (se disserem "apenas faça", declare a suposição em uma linha e vá):

Produto:    o que faz, para quem, uma frase simples
Caráter:    2-3 palavras concretas (nunca limpo, moderno, elegante, minimalista, premium)
Mundo:      o lugar ou material a que pertence; define tom neutro, destaque, imagens
Momentos:   1-2 lugares onde a tela fica rica
Assinatura: um detalhe que só este produto tem, usado consistentemente

Marcador de lacuna. [número necessário], [fonte necessária], [foto necessária] onde um fato ou recurso está faltando. audit.py copy lista os que ainda estão abertos; nenhum pode ser enviado.

Pontuação: todo comando de avaliação termina com ela

#CampoPerguntaP
1HierarquiaA coisa mais importante pode ser nomeada em 2 segundos?3
2LegibilidadeContraste, tamanho, medida, cópia real em toda largura3
3SistemaUma paleta, uma escala, uma lógica de raio, uma linguagem de movimento2
4OfícioAlinhamento, ritmo de espaçamento, estados, superfícies do navegador2
5Verdade do conteúdoDados reais, cópia específica, sem alegações inventadas3
6UsabilidadeTarefa completa; affordances óbvios; erros recuperáveis3
7DistinçãoPassa no teste de troca?2

Pontue cada um de 0 a 4 (4 = genuinamente excelente, não "ok") e compute com audit.py score. Faixas: 85+ Forte, envie e corrija apenas P0 · 70-84 Sólido, envie após os P1s nomeados · 50-69 Fraco, uma revisão real primeiro · <50 Falho, a direção está errada: reconstrua (do-design-renew). Pontue a renderização, não o código-fonte. Um campo que você não pôde verificar é u: pontua 0 e lê-se não verificado, nunca uma estimativa. Distinção recebe 4 apenas se você puder nomear o que a torna deste produto. Os três piores campos são a lista de trabalho, uma ação cada.

Severidade: P0 bloqueia o envio (quebrado, ilegível, proibição grave), relate todos · P1 danifica a confiança, top 5 · P2 ofício, top 5 · P3 polimento, liste apenas. Formato da descoberta: [Pn] localização - o que está errado - correção; descobertas de script mantêm seu ID.

Sem documento

Diga "Sem DESIGN.md: o guardrail não tem nada para aplicar." Ofereça-se para escrevê-lo (template + entrevista), ou uma adaptação retroativa a partir do código (check-design.py --init + entrevista §Retrofit): v1.0 é o que é enviado, valores antigos vão para legacy: (contados, não falhados), lacunas vão para a lista de delta do documento. Arquivos e demonstrações ficam fora de toda varredura via skip: no bloco de tokens (ou --skip a,b), por pasta ou arquivo. Pesquise por imports antes de pular: pastas de arquivo geralmente contêm partes ativas. Nunca invente um documento para que o verificador passe.

Inegociáveis

  1. Nunca quebre código funcional. Props, estado, roteamento, manipuladores e a11y sobrevivem; a cópia mantém seu significado.
  2. O briefing vence. Uma marca, fonte ou cor declarada supera o gosto, mesmo em uma lista de rejeitos. Escreva no documento (allow: no bloco de tokens desliga uma regra de verificador ou ID de auditoria intencionalmente).
  3. Nunca invente fatos, recursos ou fontes. Corte uma alegação vaga; nunca a substitua por uma específica inventada. Use um marcador de lacuna.
  4. Mantenha a voz do autor. Corte hábitos de máquina, mantenha as peculiaridades da pessoa.
  5. Densidade, não presença. Aja em agrupamentos (3+ indicações P0/P1 distintas), nunca em um gradiente ou um travessão. Um resultado limpo é válido; nunca fabrique descobertas.
  6. Corrija, nunca acuse. Nunca diga "isso parece gerado por IA"; nomeie o que não foi escolhido e o que fazer em seu lugar.
  7. Somente leitura, a menos que solicitado para revisões e auditorias.

Habilidades Relacionadas