Communitygithub.com

Web Design Playbook

Skill de design. Fluxo de trabalho de implementação de design para sites/LPs/mockups HTML. Usado em solicitações de criação, redesign ou 'deixar bonito', forçando o ciclo: camada de referência → definição de direção → implementação → validação em dispositivo real → registro de aprendizado. Também utilizado quando o usuário compartilha uma URL dizendo 'gostei deste site / use como referência'.

O que é Web Design Playbook?

O Web Design Playbook é um skill focado em garantir qualidade e consistência no design de websites, landing pages e mockups HTML. Ele centraliza o aprendizado em um arquivo de acúmulo (`~/.claude/design-taste.md`) que armazena as preferências de design do usuário e sites de referência, evoluindo com o uso para se tornar um guia pessoal de design validado. O fluxo de trabalho é estruturado em cinco etapas: (1) carregar camadas de referência (projeto, acúmulo pessoal e princípios padrão), (2) definir a direção visual com rascunhos e fixação em `DESIGN.md`, (3) implementar reutilizando componentes do Web BENTO e escolhendo animações leves, (4) validar em dispositivos reais com três larguras de tela e verificação de tipografia japonesa, e (5) registrar aprendizados no arquivo de acúmulo. O skill funciona com qualquer agente de IA (Claude Code, Cursor, Codex) que tenha acesso ao sistema de arquivos e navegador. Sua principal vantagem é que ele se torna mais preciso com o tempo, substituindo princípios genéricos por preferências comprovadas do usuário, prevenindo designs genéricos de IA e acelerando decisões visuais.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ry071702-prog/web-design-playbook/tree/HEAD/skills/web-design-playbook

Perguntar na sua IA favorita

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

Documentação

O que Web Design Playbook faz?

Um fluxo de trabalho de implementação de design para reproduzir qualidade com método. O núcleo é a iteração com o arquivo de acúmulo abaixo: absorver bons designs, aprender com os resultados e registrar esse aprendizado, fazendo com que o playbook se torne um método cada vez mais personalizado para o usuário.

Arquivo de Acúmulo (centro deste skill)

Fonte da verdade que armazena as preferências de design e sites de referência de cada usuário. Localizado em ~/.claude/design-taste.md. Se não existir, é criado automaticamente na primeira execução com este modelo:

# Design Taste — Meu Acúmulo de Design

## Princípios Comprovados
<!-- Adicione uma linha por vez: padrões que funcionaram / não funcionaram com base na reação do usuário -->

## Coleção de Sites de Referência
<!-- Adicione sites que achou legais, com uma breve descrição do que os torna bons -->
| Site | URL | O que é bom |
|---|---|---|

Quando adicionar (absorção)

  • Quando o usuário compartilhar uma URL dizendo "gostei deste site", "use como referência" ou algo similar, visite o site imediatamente, identifique e descreva em uma frase o que é bom (layout/cores/tipografia/movimento/arquitetura da informação) e adicione à coleção de sites de referência.
  • Quando a reação do usuário a um design criado revelar um padrão que "funciona" ou "não funciona", adicione uma linha aos Princípios Comprovados.

Quando ler (uso)

  • Sempre antes de implementar um design (etapa 1 do fluxo de trabalho). Use como base para decisões de direção visual, cores e movimentos.

Fluxo de Trabalho

1. Carregar Camadas de Referência (obrigatório antes da implementação)

Leia na seguinte ordem de prioridade:

  1. DESIGN.md na raiz do projeto — documento oficial específico do projeto. Prioridade máxima.
  2. Arquivo de Acúmulo ~/.claude/design-taste.md — preferências comprovadas do usuário.
  3. "Princípios de Design (valores iniciais)" abaixo — valor padrão quando os dois primeiros não se aplicam.

2. Definir Direção

  • Se o tom ainda não estiver definido, primeiro crie um rascunho de uma tela (seção hero + seções representativas) para apresentar e obter aprovação da direção. Mudar de direção depois de criar todas as páginas é o que há de mais caro.
  • Uma vez definida a direção, fixe-a no formato DESIGN.md (tokens YAML + prosa de intenção). A partir daí, qualquer implementador (humano ou IA) que ler este arquivo manterá o tom consistente.

3. Implementação

  • Antes de criar componentes decorativos (botões/títulos/cards/loaders/padrões de fundo, etc.) do zero, verifique se já existem no Web BENTO.
    • Páginas individuais: https://amix-design.com/tl/web-bento/parts/<slug>.html (slug = gradient / heading / button / card / text-effect / divider / hover / glass-shadow / badge / loading / form / background-pattern / speech-bubble / list / alert / table)
    • Ao reutilizar, adapte às cores, bordas arredondadas e fontes do projeto (uso comercial permitido, sem necessidade de créditos. Apenas a redistribuição como coleção de componentes não é permitida, portanto não inclua diretamente no repositório).
  • Considere animações mais leves primeiro: CSS / Framer Motion → Rive / Lottie → Three.js. Respeite sempre prefers-reduced-motion.

4. Validação em Dispositivo Real (obrigatório antes do deploy)

  • Tire screenshots no navegador em pelo menos 3 larguras: 390 / 880 / 1280px, e inspecione visualmente (use Chrome DevTools MCP ou similar). O build passar é uma coisa; a aparência estar correta é outra.
  • Verificação de Japonês: quebra de linha inadequada em títulos (partículas isoladas no início de linha, palavras quebradas no meio), elementos cortados, informações que só aparecem ao passar o mouse.
  • Como lidar com quebras de linha em Japonês: divida blocos de significado com nowrap / use word-break: auto-phrase / envolva palavras que não devem ser quebradas em spans com nowrap.

5. Registrar Aprendizado

  • Quando a reação do usuário revelar um padrão que "funciona" ou "não funciona", adicione imediatamente uma linha aos "Princípios Comprovados" no arquivo de acúmulo.
  • Repetindo esse ciclo, os critérios de decisão passarão de "princípios gerais" para "preferências comprovadas deste usuário". Esse é o verdadeiro valor deste playbook.

Princípios de Design (Valores Iniciais)

Valores padrão até que o arquivo de acúmulo tenha evidências suficientes. São apenas iniciais; sinta-se à vontade para alterá-los se não servirem:

  • Base branca + uma cor de destaque + tipografia grande + motivo concreto do tema. Abordagens multicoloridas ou escuras com dourado ("luxuosas") tendem a parecer genéricas de IA.
  • Interações lúdicas em resposta a ações + movimento com sensação de evento, mas sem jamais sacrificar a legibilidade da informação.
  • Emoção transmitida por metáforas do tema (exemplo: site de torneio de futebol → página de jornal; evento de exibição de filme → festival escolar). Não recorrer a combinações genéricas de gradiente + cartão de vidro.

Guia de Personalização (modifique para seu uso)

ItemComo personalizar
Princípios de Design (valores iniciais)Quando seus próprios padrões comprovados se acumularem, o arquivo de acúmulo será a referência principal. Esta seção pode ser removida ou substituída pelos seus próprios padrões.
Local do arquivo de acúmuloPara compartilhamento em equipe, coloque-o dentro do repositório (ex.: design/taste.md) e atualize o caminho no texto.
Larguras de validação 390/880/1280pxAjuste para os breakpoints reais do projeto.
Verificação de JaponêsPara sites multilíngues, substitua pela verificação tipográfica do idioma alvo (hifenização, etc.).
Fonte de referência de designSe você tem um designer ou escola de design de sua preferência, adicione essa referência na etapa 1.

Proibições

  • Não criar IPs, personagens ou produtos fictícios com geração de imagens por IA (é especialmente arriscado em contextos que lidam com IPs reais). Decoração permitida apenas com: formas abstratas, tipografia, cores da marca, assets oficiais ou fotografias reais.
  • Não incluir no repositório coleções de assets com redistribuição proibida ou conteúdo de terceiros (apenas referencie via links).

Recomendações de Uso (Opcional)

  • Taste Skill — Guardião de qualidade contra soluções genéricas: npx skills add Leonxlnx/taste-skill -g -s design-taste-frontend (+ high-end-visual-design / redesign-existing-projects)
  • Validação de DESIGN.md: npx @google/design.md lint

Habilidades Relacionadas