Communitygithub.com

design-system-local

Use esta habilidade sempre que a entrega for visual: um arquivo HTML/CSS, um artefato web, uma landing page, um pôster, um relatório ou página de memorando, um mockup de painel ou qualquer página que uma pessoa irá olhar. Ela rege apenas o gosto e a estrutura — como a coisa é entregue (ferramenta de artefato, arquivo, exportação) é decidido pela própria tarefa.

O que é design-system-local?

Esta habilidade, chamada 'local-design-system', é um conjunto disciplinado de regras de design para páginas visuais, artefatos e saída HTML/CSS. Ela é ativada sempre que a entrega é visual, como arquivos HTML/CSS, artefatos web, landing pages, pôsteres, relatórios, mockups de painel ou qualquer página que uma pessoa irá olhar. A habilidade foca exclusivamente no gosto e na estrutura — como o resultado é entregue (através de uma ferramenta de artefato, arquivo ou exportação) é decidido pela tarefa em si. A habilidade enfatiza a coleta de contexto de design (marca, sistema existente, capturas de tela) antes de inventar algo, e recomenda escolher uma direção estética deliberada quando não há restrições. Ela exige a definição de um conjunto de tokens CSS (como cores, tipografia, espaçamento, raio) em um bloco `:root` antes de escrever o layout, e impõe regras duras contra 'sujeira visual', como gradientes decorativos, conteúdo gerado artificialmente (lorem ipsum, dados falsos) e cromo falso. A acessibilidade é incorporada desde o início, com uso de elementos reais (`<button>`, `<a>`, `<input>`), contraste de texto adequado e alvos de toque de pelo menos 44px. A habilidade cobre layout com Flexbox/Grid, páginas fluidas, diagramas inline SVG, e oferece orientação específica para landing pages (com uma proposta clara, prova social e uma ação principal) e peças impressas (tamanhos de papel reais, margens seguras). Para trabalhos com a marca Anthropic/Claude, ela fornece valores exatos de cores e tipografia. A habilidade também referencia documentos externos para raciocínio aprofundado, cores da marca, tipografia e ofícios de impressão.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/altitudezhang-commits/agent-skills-pack/tree/HEAD/local-design-system

Perguntar na sua IA favorita

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

Documentação

Disciplina de design para páginas, artefatos e saída HTML/CSS

Use esta habilidade sempre que a entrega for visual: um arquivo HTML/CSS, um artefato web, uma landing page, um pôster, um relatório ou página de memorando, um mockup de painel ou qualquer página que uma pessoa irá olhar. Ela rege apenas o gosto e a estrutura — como a coisa é entregue (ferramenta de artefato, arquivo, exportação) é decidido pela própria tarefa.

Atribuição: as regras abaixo são adaptadas das habilidades design e design-system internas do BaoCut, que foram portadas da habilidade anthropic-design da Anthropic (consulte a nota de origem em references/brand-colors.md). Mecanismos de canvas do BaoCut (.dc.html, DCLogic, canvas.json, design_check, ferramentas de importação de assets) foram deliberadamente removidos; tudo aqui assume que você escreve HTML/CSS puro diretamente. Nas referências copiadas, leia "board/artboard" como a página ou arquivo que você está produzindo e <helmet> como <head>.

Decida a direção antes de qualquer layout

  • Reúna o contexto de design antes de inventar qualquer coisa: a marca do usuário, um sistema de design existente, o código-fonte ou página ao lado da qual isso ficará, capturas de tela ou arquivos que ele forneceu. Um design de alta fidelidade cresce a partir desse contexto; simular um produto inteiro do zero é o último recurso e produz um trabalho ruim.

  • Quando uma marca ou sistema de design for especificado, combine-o exatamente — cores, tipo, espaçamento, raio, fontes — e deixe-o substituir todos os padrões desta habilidade. Quando o usuário nomear uma marca ou produto, peça ou busque seus ativos reais, em vez de projetar no escuro.

  • Quando ninguém puder responder e nenhum sistema o restringir, escolha uma direção estética nomeada e deliberada (brutalmente minimalista, maximalista, retro-futuro, editorial, brutalista, art déco, pastel suave, industrial, luxuoso, lúdico…) e declare suas suposições em uma linha, depois construa. Nunca termine com uma pergunta que ninguém possa responder; nunca convirja silenciosamente para a mesma aparência todas as vezes.

  • Se duas ou mais decisões mudariam o resultado e alguém puder responder, pergunte uma vez antes de construir — no máximo 4 perguntas, cada uma oferecendo 2–4 opções concretas e genuinamente diferentes (sua recomendação primeiro), nunca uma coleta de requisitos padronizada. Caso contrário, decida, diga o que escolheu e prossiga.

Defina o conjunto de tokens antes de construir

  • Antes de escrever o layout, escreva um pequeno conjunto de tokens e use apenas esses valores. Coloque-o em um bloco de propriedades customizadas CSS :root no topo do arquivo (ou em um arquivo de tokens que a página carrega) — toda cor, tamanho e fonte que a página usa remonta a ele, uma fonte por valor:
:root{
  --surface: #faf7f2;              /* a única base tonal */
  --ink: #211d19;
  --accent: oklch(0.62 0.14 45);   /* 0–2 acentos, oklch */
  --font-display: "Space Grotesk", "Avenir Next", sans-serif;
  --font-body: "Source Sans 3", system-ui, sans-serif;
  --space-1: 4px; --space-2: 8px; --space-3: 16px; --space-4: 24px; --space-5: 40px;
  --radius-sm: 6px; --radius-md: 10px;
}
  • Cor: uma base tonal (quente, fria ou neutra). Brancos e pretos carregam um leve matiz — a saturação de um branco puro fica abaixo de 0,02; nunca use #FFF puro como fundo de página inteira. Acentos: 0–2, expressos em oklch com o mesmo croma e luminosidade, diferindo apenas no matiz. Prefira cores da marca/sistema; se muito restrito, derive cores oklch harmoniosas a partir delas em vez de inventar novos matizes.

  • Tipo: 1–3 famílias — uma face de exibição distinta combinada com uma face de corpo refinada. Toda webfont recebe um fallback de sistema com correspondência métrica, porque o fallback é o que renderiza enquanto a fonte carrega e onde quer que ela não possa ser incorporada. Evite padrões genéricos como primeira escolha: nada de Inter, Roboto, Arial ou Fraunces. O espaçamento entre letras permanece 0, a menos que um efeito deliberado exija o contrário.

  • Também fixe uma pequena escala tipográfica (display / título / cabeçalho / corpo / pequeno / legenda com tamanho, peso, altura da linha), uma escala de espaçamento e uma escala de raio na mesma passagem de token. Valores exatos de uma fonte real são copiados exatamente — nunca arredondados ou ajustados a uma grade de 4/8px.

Regras anti-sujidade (rígidas)

  • Sem grandes lavagens de gradiente ou fundos gradientes como decoração, sem gradientes azul-roxo, sem cards arredondados com borda colorida à esquerda, sem emoji como ícones ou glifos de interface (ícones são SVG de traço inline ou um conjunto de ícones real; emoji aparece apenas quando é genuinamente parte da marca).

  • Sem conteúdo de enchimento: sem lorem ipsum, sem estatísticas inventadas, depoimentos ou "sujidade de dados" adicionados para preencher espaço. Cada elemento ganha seu lugar; uma seção com sensação vazia é um problema de layout, não um convite para invenção de conteúdo. Fatos ausentes tornam-se placeholders visivelmente marcados, como [SEU PREÇO].

  • Sem cromo falso: nunca desenhe uma barra de status de telefone ou teclado falsa dentro de um mockup de dispositivo.

  • Combine a ambição da execução com a direção: designs maximalistas ganham efeitos ricos; designs mínimos ganham contenção e precisão no espaçamento e detalhe. Uma cor dominante com acentos nítidos supera uma cor timidamente distribuída de forma uniforme; assimetria, sobreposição, espaço em branco generoso ou densidade controlada superam uma grade centralizada padrão.

Mecânicas de layout

  • Organize grupos de irmãos (botões, chips, cards, itens de navegação, barras de ferramentas) com flex ou grid mais gap — nunca com nós de texto de espaço em branco ou margens por elemento entre irmãos. O fluxo inline é para prosa com o ocasional <a>/<strong> dentro dela, não para organizar elementos de interface.

  • Páginas são fluidas: sem largura em px na raiz, um contêiner com max-width e padding lateral, dimensionamento com %/rem/fr, grids escritas como repeat(auto-fit, minmax(min(<min>px, 100%), 1fr)) para que colapsem em uma coluna em um telefone em vez de transbordar. vh apenas para raízes que realmente preenchem a tela; seções seguidas por mais conteúdo usam min-height em px/rem. Prefira ligeiramente muito alto a cortado.

  • Raízes de tamanho fixo são apenas para formatos fixos: mockups de dispositivo, pôsteres, imagens sociais, peças impressas. Telas de aplicativos móveis têm 390×844; as páginas são projetadas para funcionar na largura do telefone — os títulos não devem quebrar de forma estranha, as grades não devem esmagar, o texto não deve encolher abaixo da legibilidade.

  • Diagramas em uma página de entrega são SVG inline comum (em um <figure> está ok); mantenha rótulos e chamadas como texto real onde alguém possa precisar editá-los.

Acessibilidade é desenhada, não verificada depois

  • Use elementos reais mesmo em um mockup estático: <button>, <a href>, <input> com um <label>. Nunca coloque role ou onClick em um div/span como substituto — os teclados os ignoram e os leitores de tela não obtêm nada. Botões somente com ícone recebem aria-label; SVG decorativo recebe aria-hidden="true", SVG significativo recebe role="img" e um rótulo.

  • O contraste do texto é de pelo menos 4,5:1 contra o que está atrás dele (3:1 para texto de 24px ou mais). As falhas comuns são texto de legenda cinza e preenchimentos coloridos sob texto branco — escureça ambos até passarem.

  • Cores que devem ser distinguidas também devem diferir em luminosidade, não apenas em matiz; prefira azul/laranja a vermelho/verde.

  • Os alvos de toque têm pelo menos 44px. O texto do corpo impresso tem pelo menos 12pt.

Disciplina de conteúdo e edição

  • Pergunte antes de adicionar material: se seções, páginas ou texto extras melhorariam a peça, pergunte primeiro em vez de adicioná-los sem serem solicitados.

  • Uma alteração pequena e direcionada altera apenas esse local: todo outro valor de layout, espaçamento, fonte, tamanho, posição, cor e conteúdo permanece exatamente como estava. Faça a alteração solicitada e, em seguida, sugira algo maior em vez de fazê-lo sem ser solicitado. Um pedido para redesenhar ou começar do zero é diferente — então faça a grande alteração.

  • Ao estender uma página ou documento existente, primeiro leia seu vocabulário visual — copie estilo, paleta, tom, estados de hover, padrões de sombra e card, densidade — e escreva nele.

  • Ao ser solicitado a reproduzir uma interface para a qual você pode obter o código-fonte, trabalhe a partir da fonte real: leia os componentes e estilos, copie os ativos reais, copie valores exatos. Nunca reproduza de memória ou de uma captura de tela quando o código-fonte existir. Não reproduza o design proprietário distinto de outra empresa para alguém que não trabalha lá; ofereça um design original voltado para o objetivo real deles.

Landing pages e impressão

  • Landing pages: um herói que diz em uma frase o que é oferecido, com uma chamada para ação clara; prova que um visitante pode confiar (depoimentos, logotipos, números — os deles, ou placeholders visivelmente marcados); seções de benefícios que respondem a objeções reais em vez de listar recursos. Uma ação primária por página, repetida à medida que a página desce. O texto é o produto: específico, enraizado no que o usuário realmente vende, nunca um modelo de marketing intercambiável.

  • Peças impressas (pôsteres, panfletos, brochuras, memorandos, relatórios, qualquer coisa exportada para PDF): leia references/print.md antes de começar — decida página fixa vs. documento fluido primeiro, use tamanhos de papel reais (Carta 816×1056, A4 794×1123 px CSS), margens seguras ≥40px, regras ≥1px, texto cinza não mais claro que #767676 e hierarquia de panfleto legível em uma sala em três segundos.

Trabalho com a marca Anthropic

  • Para trabalhos que usam a marca Anthropic/Claude: base Ivory #FAF9F5, texto Slate #141413, acento Clay #D97757, tipo de exibição serifado com corpo sem serifa. A rampa completa de cinzas quentes, paleta auxiliar e regras de logotipo estão em references/brand-colors.md; as pilhas de fontes e a escala tipográfica estão em references/brand-typography.md. O hábito de base creme + título serifado + terracota é para trabalhos com a marca Anthropic ou quando um briefing pede por isso — não um padrão para tudo.

Referências

  • references/craft.md — a lógica completa por trás dessas regras: escolher a direção com o usuário, variações e rodadas de wireframe, estrutura de landing page, reprodução de interfaces a partir do código-fonte e as regras de conteúdo compartilhadas. Leia quando uma decisão de design for contestada ou uma peça precisar de profundidade.

  • references/brand-colors.md — sistema de cores da marca Anthropic (cinzas quentes, paleta Claude, escalas de visualização de dados) e sua nota de origem.

  • references/brand-typography.md — pilhas de fontes da marca Anthropic com fallbacks de correspondência métrica e a escala tipográfica da marca.

  • references/print.md — ofícios de impressão: páginas fixas vs. fluidas, tamanhos e unidades de papel, margens, tabelas, regras de panfleto.

Habilidades Relacionadas