Communitygithub.com

Manual de Marca

Cria o manual de marca (brandbook) como um deck de Slides a partir do logo SVG e da proposta de branding já aprovada: versões do logo, retícula, área de proteção, tamanhos mínimos, cor CMYK/Pantone, tipografia com licenças e .zip do logo. Use quando solicitarem um brandbook, manual de marca, manual de identidade, guia de uso do logo ou normas de marca, mesmo que não digam "manual". Não use para criar a estratégia (isso é proposta-branding) nem para mostrar a marca aplicada em peças (isso é brand-board).

O que é Manual de Marca?

Esta skill transforma uma identidade visual já definida (logo + estratégia de branding) em um manual de marca normativo e completo, no formato de um deck de slides (Google Slides). Ela guia o usuário por um processo estruturado em 9 fases: desde a coleta dos insumos obrigatórios (logo SVG e apresentação de branding), passando pela análise do SVG, entrevista para definir regras, geração de versões do logo, retícula construtiva, sistema de cores com validação Pantone, definição tipográfica com licenças, até a construção do deck final e empacotamento dos arquivos. A skill é projetada para ser meticulosa e defensável: cada decisão é documentada com parâmetros mensuráveis (contraste, ΔE, tamanhos mínimos) e aprovada pelo usuário antes de ser aplicada, evitando retrabalho. Ela se apoia em scripts Python especializados (svg_inspect, logo_variants, color_system, pantone_ref, etc.) e referências internas, e suporta plataformas como Figma (via conector oficial) e Google Fonts. O resultado é um manual que pode ser entregue diretamente ao cliente, incluindo o deck editável, um .zip com os SVGs e uma lista de pendências por responsável.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/albdanyb22/skills-branding/tree/HEAD/manual-de-marca

Perguntar na sua IA favorita

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

Documentação

O que Manual de Marca faz?

Converte uma identidade já decidida (logo + estratégia) em um manual normativo: o documento que diz ao cliente, à sua equipe e aos seus fornecedores como usar a marca sem que a designer esteja presente. O manual documenta decisões; não as toma por conta própria. Por isso esta skill pergunta muito e gera pouco sem aprovação: cada coisa que o manual afirma tem que poder ser defendida perante o cliente.

Ritmo de toda a skill: uma pergunta de cada vez, sempre com sua recomendação e uma linha de porquê. Quando a pessoa aceitar sem discutir, nomeie em uma frase o que aquilo implica (o custo) e siga. Mantenha a contagem em voz alta ("Bloco 3 de 6 — Cor"). Se algo pode ser descoberto olhando (o PPT, o SVG, o site de uma licença), descubra em vez de perguntar.

Ferramentas

A skill usa scripts e guias próprios, em scripts/ e references/ junto a este arquivo. Os scripts usam Python com Playwright/Chromium, Pillow, numpy e scipy; text_to_svg.py precisa também de uharfbuzz (pip install --break-system-packages uharfbuzz). Todos aceitam -h. Guias:

  • references/entrevista.md: banco de perguntas em ordem, com a recomendação padrão.
  • references/nucleo.md: páginas do manual básico.
  • references/modulos.md: módulos estendidos (tomados como referência do manual público da FIFA World Cup 26).
  • references/esqueleto-slides.md: maquete editorial fixa e construção técnica do deck.

Mantenha uma lista de tarefas visível (análise, entrevista, versões, construtivo, cor, deck, pacote): o trabalho é longo e a pessoa pode ir e voltar.

Fase 0 — Entradas obrigatórias

Peça em uma única mensagem o que faltar:

  1. O logo em SVG, com o texto em contornos. Se só houver PNG/JPG, pare: sem SVG não se mede nem se geram versões confiáveis. Peça também qualquer outro SVG que exista (outras versões, retícula construtiva).
  2. A apresentação de branding anterior: Google Slides (a que propuesta-branding produz), .pptx ou PDF. Se não existir, pare e sugira executar propuesta-branding: o manual não inventa estratégia.

Leia a apresentação (para .pptx, python -m markitdown ou python-pptx; extraia também as imagens das páginas de identidade visual e olhe-as: lá costumam estar o sistema de logo, a paleta aplicada e as peças). Monte uma ficha: quem somos, missão, visão, valores, personalidade, tom (diz / evita), posicionamento, mantra, conceito do logo, moodboard, type board, paleta, tipografias e regras implícitas (por exemplo "o nome sempre em preto, o prefixo muda de cor"). Se faltar um campo que o manual precisa, pergunte só por esse campo. Se uma cor aparecer sem HEX legível, mostre-a da imagem e peça confirmação.

Fase 1 — Analisar o SVG

python scripts/svg_inspect.py logo.svg trabalho/inspecao/

Mostre inspecao.png e proponha os grupos. Normalmente são isotipo / logotipo / tagline, mas se a identidade é dinâmica (uma parte muda de cor por sub-marca, edifício, sede…), agrupe por regra de cor: o que muda, o que é fixo e o que acompanha o que muda. Assim cada variante é gerada com uma única instrução. Confirme-os e salve-os em trabalho/grupos.json (por exemplo {"prefixo": ["1-4"], "nome": ["5-10"], "simbolo": [0]}). Atenda aos ALERTAS: texto vivo, traços não expandidos, degradês, imagens embutidas.

Fase 2 — Entrevista

Siga references/entrevista.md (6 blocos: escopo → logo → cor → tipografia → linguagem visual e aplicações → controle do documento). Pode dar como resolvidas em uma mesma mensagem as decisões de baixo risco ("assumo X a menos que me corrija"); as que custam caro reverter vão sozinhas.

Ao terminar, apresente o índice resultante (núcleo + módulos, com número de página) e aguarde aprovação antes de produzir qualquer coisa.

Fase 3 — Versões do logo (sempre com aprovação prévia)

Variantes de cor. Gere a proposta e mostre-a como folha; depois uma tabela: grupo de variantes · como se resolve · uso, mais as decisões que tomou. As dúvidas típicas que deve levantar ou resolver com a tabela de contraste da Fase 5:

  • Em negativo, a cor se mantém ou passa para branco? Um negativo em cor só existe se essa cor contrasta com o fundo escuro (≥ 3:1); senão, monocromático branco.
  • Sobre um fundo que é uma cor da própria paleta, o logo vai em uma única tinta (preto ou branco), nunca em outra cor da paleta.
  • Em uma cor, algum detalhe interno se funde com a forma de trás? Proponha furar ("furar" no spec).
  • Em identidades dinâmicas: a peça acompanhante (o símbolo, por exemplo) pode ter uma cor diferente? Recomende que não (uma peça = uma cor) e nomeie o custo.
python scripts/logo_variants.py logo.svg trabalho/variantes.json trabalho/versoes/ --version empilhada

Recomposições (horizontal ↔ vertical, símbolo sozinho, avatar, lock-ups):

  1. Pergunte se já existe o SVG; se existir, use-o.
  2. Se não, componha com compose.py: apenas reposiciona, escala e separa peças existentes; nunca redesenha. Para passar de duas linhas para uma, use "alinhar": "base" com a linha base de cada grupo (pé de uma letra sem descendente) e uma separação igual ao espaço entre letras dentro da palavra, para que se leia como uma única palavra.
  3. Mostre a pré-visualização (no avatar, também _circulo.png; para o favicon, o teste a 32 e 16 px) e aguarde aprovação uma por uma.
  4. Após aprovação, gere suas variantes compondo cada variante de cor aprovada (loop sobre os SVGs da versão principal).

Lock-ups com texto (slogan, nome de sub-marca ou edifício): converta o texto em contornos com a tipografia da marca, sem depender da fonte instalada, e adicione como peça externa:

python scripts/text_to_svg.py "Conecta. Vive. Pertence." fonte.woff trabalho/slogan.svg --color "#1D1D1B"

(as fontes do Google Fonts são obtidas com npm i @fontsource/<familia>; use o .woff). Em compose.py, "externos": {"slogan": "trabalho/slogan.svg"} e "largura": {"slogan": "logo"} igualam a largura à do logo. Para uma sub-marca sem nome definido, deixe um marcador ("[Nome]") e normalize a estrutura, não cada caso. O texto do lock-up vai na tinta da parte fixa do logo, nunca na cor variável.

Usos incorretos, com o logo real (--fundo-ruim: a cor da paleta com pior contraste para a versão principal):

python scripts/incorrect_uses.py trabalho/versoes/<principal>.svg trabalho/incorretos/ --grupos g.json --nome "<marca>" --fundo-ruim "#2B57E2"

(g.json precisa de um grupo isotipo com o símbolo e o restante como logotipo).

Fase 4 — Retícula, proteção e tamanho mínimo

  1. Pergunte se a pessoa tem retícula construtiva e peça o SVG dela. Se tiver, use-a tal qual. Se não:
  2. python scripts/construction.py candidatos logo.svg trabalho/construtivo/ --grupos trabalho/grupos.json e mostre os candidatos em uma única folha. Costuma funcionar bem combinar dois: a espessura do traço como módulo do plano (cai sobre as hastes) e a largura do símbolo como medida da área de proteção ("deixe livre o espaço de um símbolo", fácil de explicar a qualquer fornecedor). Cobranding: o dobro.
  3. python scripts/construction.py plano <versao>.svg trabalho/construtivo/<versao> --modulo <u> --protecao <modulos> para cada versão.
  4. python scripts/min_size.py <versao>.svg trabalho/minimos/<versao> --grupos g.json (g.json com logotipo e, se houver, tagline). Se houver ranhuras finas (a cruz de um símbolo), o script dá dois limiares: [completo] tudo se lê / [legível] o nome se lê e o símbolo fica como um ponto. Monte uma folha de teste com cada versão em vários tamanhos (real e ampliado) e deixe a pessoa escolher. O usual: o mínimo oficial é o [legível], e em formatos pequenos (assinatura, crachá) o símbolo aparece também separado e grande.

Fase 5 — Sistema de cor

  1. Monte trabalho/cores.json: um HEX fonte por cor, função, e os RGB/CMYK/Pantone que vierem do material de origem, para validá-los.
  2. Se a pessoa não tem Pantone validados, ofereça-se para fazer o trabalho: python scripts/pantone_ref.py trabalho/cores.json trabalho/pantone_ref.json (Pantone C e têxtil TCX mais próximos por ΔE 2000). Copie o resultado para cores.json e apresente em uma tabela com o ΔE: < 2 quase idêntico, 2–5 parecido, > 5 nota-se, > 10 sem equivalente.
  3. python scripts/color_system.py trabalho/cores.json trabalho/cor/: converte para CMYK com o perfil FOGRA39 se o encontrar, avisa das cores fora de gama (como ficarão impressas), valida RGB/HEX, calcula escalas 50–950 e a matriz de contraste.
  4. Apresente os ALERTAS antes de projetar. Explique quais cores saem apagadas em CMYK e onde convém Pantone direto (adesivos, sinalização). Todo Pantone/TCX calculado vai no manual como "referência, validar com guia física e prova de cor". Nunca o apresente como oficial. Em preto, distinga preto enriquecido (áreas grandes) de 0/0/0/100 (textos).
  5. A matriz de contraste decide a tinta de texto e a do logo sobre cada fundo. Se o PPT disser "X sempre em preto" e o contraste o impedir em algum fundo, diga e proponha a regra corrigida ("X na tinta que contraste").

Fase 6 — Tipografia e licenças

Procure a licença de cada fonte no site antes de perguntar:

  • Google Fonts / OFL: ok.
  • "Grátis para uso pessoal": não cobre um logo comercial. Pergunte de onde a pessoa tirou.
  • Envato Elements: cobre logos, mas é preciso registrar a fonte para aquele projeto enquanto a assinatura estiver ativa e guardar o certificado PDF. Se não o fez, é o pendente mais importante; coloque no manual um marcador do código de licença.
  • Restrita a um sistema (por exemplo SF Pro): avise e proponha uma alternativa livre.

A fonte do logotipo, se for entregue em contornos, declara-se "apenas na arte do logo; não se instala". Defina uma fonte de backup (Google Docs/Canva e Word) e a hierarquia com exemplos escritos com a voz da marca.

Ilustrações de terceiros (bancos, comunidade do Figma): revise também sua licença (Streamline Free, por exemplo, exige atribuição, permite 25 por projeto e proíbe redistribuí-las). Se não puderem ser entregues a terceiros, o manual as mostra como estilo de referência com o crédito, e não vão no .zip. Para trazê-las do Figma use o conector oficial (create_session → get_metadata → get_screenshot com base64; o arquivo fica salvo em disco). No plano Starter as chamadas são limitadas: localize e escolha antes de baixar. Se o conector local do Figma retornar "Token expired", o token se altera na configuração do app (ou em Settings → Extensions), não no arquivo; enquanto isso use o conector oficial ou peça a exportação.

Fase 7 — Construir o deck

Leia references/esqueleto-slides.md. Crie o deck a partir do tipo Slides (título: "Manual de marca – ") e siga suas instruções de arquivos:

  1. Renderize para PNG transparente tudo o que vai no deck (versões, planos, testes de mínimo, usos incorretos, ilustrações) e envie como recursos de uma pasta do diretório de trabalho, até 25 por chamada.
  2. deck.json primeiro, com o order completo (núcleo + módulos + separadores) e as fontes da marca em faces (Google Fonts); depois a capa, e depois lotes de 6–8 páginas.
  3. Textos de estratégia: do PPT, em registro de manual, sem adicionar afirmações. O que faltar vai entre colchetes ("[e-mail]"), na página e nas notas do orador.
  4. Aplicações do ramo: construa-as no slide com formas, o PNG do logo e textos de exemplo com a voz da marca. Não são mockups fotográficos.
  5. Verifique se o nome da marca está correto em cabeçalhos e índice.

Fase 8 — Pacote de arquivos

Copie para uma pasta apenas os SVGs aprovados, com nome <versao>_<variante>.svg (sem pré-visualizações nem peças soltas), e execute:

python scripts/package.py trabalho/entrega/ trabalho/pacote/ --marca "<Marca>"

Gera SVG, PNG transparente 500/1000/2000 px e PDF vetorial por variante, em RGB. As versões CMYK/Pantone, as simplificadas para bordado e o favicon de 16 px ajustado ficam como "pendentes de arte final". Envie o .zip com SendUserFile.

Fase 9 — Entrega

Mensagem breve: o deck (seu card já leva o link), o .zip e a lista de pendentes agrupada por responsável (designer / cliente / gráfica). Exemplos: registrar a licença da fonte, validar Pantone, o e-mail do responsável pela marca, a arte final para bordado, a licença das ilustrações. Como passo opcional, ofereça executar brand-board ou produzir os templates.

Exemplo bom

Assim se documenta uma decisão no manual: concreta, mensurável e com seu estado.

Cor · Azul
HEX #2B57E2 · RGB 43/87/226 · CMYK 85/65/0/0 (FOGRA39, sai um pouco apagado)
Pantone 2728 C · ΔE 3,1 (parecido). Referência: validar com guia física e prova de cor.

Tamanho mínimo · Versão horizontal
24 mm / 90 px de largura: o nome se lê e o símbolo fica como ponto.
Menor (assinatura, crachá): usar o símbolo separado e grande.

Exemplo ruim

Pantone oficial: 2728 C
Não usar o logo muito pequeno.

Por que está errado: apresenta um Pantone calculado como oficial e sem ΔE, e o mínimo não tem medida, então nenhum fornecedor consegue verificar se o cumpre.

O que esta skill nunca faz

  • Redesenhar ou "melhorar" o logo: apenas recoloriza, fura, reposiciona, escala e separa peças existentes, e converte em contornos textos novos.
  • Criar uma versão sem aprovação prévia.
  • Inventar estratégia, licenças ou dados do cliente, nem apresentar Pantones calculados como oficiais.
  • Misturar valores de cor de fontes diferentes sem validá-los.

Individual skills in this repo

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

Habilidades Relacionadas