Skills que
aplicam uma
identidade

1.1 As duas metades do trabalho de marca

1.2 O que a torna a categoria mais mal usada

1.3 O que este volume é

2.1 O que lá vai

---
name: identidade-visual
description: Os valores exactos da identidade — cores, tipos, espaçamentos,
  logótipo, tom. Use SEMPRE que produzir qualquer peça visual ou texto
  público: apresentações, páginas, imagens, documentos, propostas.
---

# Identidade

## Cores — use apenas estas
| Papel | Valor | Onde |
| Superfície | #FAF6EF | fundo |
| Tinta | #1E1912 | texto |
| Acento | #932E14 | ligações, destaques (máx. 10% da área) |

NUNCA introduza um hexadecimal que não esteja nesta tabela.
Se precisar de um tom intermédio, use `references/ESCALAS.md`.

## Tipos
Títulos: X, peso 600. Corpo: Y, peso 400. Nunca uma terceira família.

## Logótipo
Ficheiros em `assets/logo/`. Nunca redesenhar, nunca esticar,
nunca aplicar sobre fundo com contraste inferior a 3:1.
Área de protecção: metade da altura do símbolo, em toda a volta.

## Proporção
60% superfície, 30% tinta e estrutura, 10% acento.

2.2 Porque funciona

2.3 O que a maioria esquece de incluir

• As proibições, e não só as permissões. «Nunca sobre fotografia sem caixa», «nunca em itálico», «nunca com sombra».
• As proporções. Uma paleta sem proporções produz peças com todas as cores em partes iguais — o erro do volume de Cor, secção 3.5.
• Os contrastes já calculados. Que par de cores serve para texto e qual não serve. Poupa ao agente uma conta que ele faz mal.
• O que fazer quando a regra não chega. «Se precisar de uma cor que não está aqui, pergunte — não invente.» É a instrução mais importante e a mais esquecida.

2.4 A skill oficial que serve de modelo

A Anthropic publica brand-guidelines, que aplica a sua própria identidade — cores e tipografia — a qualquer artefacto. Não serve para a sua marca, e serve como modelo de estrutura: mostra que uma skill de identidade é sobretudo uma tabela de valores mais um conjunto de proibições, e que isso chega.

Repare também na descrição dela: lista palavras-chave explicitamente — branding, identidade corporativa, cores de marca, tipografia, formatação visual. É a técnica do volume I, cap. 4.3: pôr na descrição o vocabulário que as pessoas usam ao pedir.

3.1 As três tarefas de paleta

3.2 A skill de derivação, com script

---
name: derivar-paleta
description: Deriva a paleta completa a partir de uma cor-âncora em OKLCH —
  neutros temperados, semânticas de peso igual e rampas de 50 a 950 — e
  verifica todos os contrastes. Use ao criar ou rever uma paleta, ao
  acrescentar uma cor, ou quando pedirem tons, escalas ou variações.
---

# Derivar uma paleta

1. Peça a âncora em OKLCH. Se vier em hexadecimal, converta e
   mostre o valor OKLCH antes de continuar.
2. Corra `scripts/derivar.py <L> <C> <H>`. Produz neutros,
   semânticas e as rampas.
3. Corra `scripts/contraste.py` sobre o resultado.
   Não apresente nenhuma paleta sem a tabela de contrastes.
4. Marque explicitamente que degraus servem para texto e quais não.

## Nunca
- Nunca escolha cores a olho em hexadecimal — sempre OKLCH.
- Nunca apresente uma rampa sem um degrau que passe 4.5:1 sobre branco.
- Nunca dê a mesma luminosidade a matizes diferentes sem verificar:
  amarelo e azul ao mesmo L não têm o mesmo contraste.

A última proibição é a que evita o erro mais comum, e vem directamente de Cor, secção 1.3.

3.3 A skill de tematização

A Anthropic publica theme-factory: aplica um tema — cores e tipos — a artefactos como apresentações, documentos, relatórios e páginas, com dez temas pré-definidos ou gerando um novo.

3.4 A verificação que só uma skill faz sem se cansar

• Todos os pares texto/fundo acima de 4.5:1, e os elementos de interface acima de 3:1.
• Nenhum valor fora da paleta — varrer a peça e listar os intrusos.
• Proporções respeitadas — o acento não passa dos 10% da área.
• Em escala de cinzentos ainda se distingue — o teste de Cor, secção 5.8, caso 4.

São quatro verificações mecânicas que uma pessoa faz mal ao fim da terceira peça e um script faz igual à milésima.

4.1 O que uma skill não faz

4.2 Onde ajuda muito

4.3 Uma skill de testes de esforço

## Antes de aprovar qualquer logótipo

Corra `scripts/esforco.py logo.svg`. Produz e avalia:
1. 16px, 32px, 64px  → algum detalhe fecha?
2. escala de cinzentos → os elementos ainda se distinguem?
3. só contorno        → a silhueta ainda se lê?
4. sobre 6 fundos     → contraste mínimo 3:1 em todos?
5. invertido          → funciona em negativo?

Se falhar em 1 ou 2, o problema é de desenho, não de aplicação.
Reporte qual falhou e porquê. Não sugira «aumentar o tamanho».

A última linha é a que importa: impede a resposta fácil. Um logótipo que só funciona grande é um logótipo por terminar, e a skill tem de o dizer em vez de contornar.

4.4 Moodboards: o uso mais bem calibrado

5.1 Porque o tom de voz é o caso ideal

5.2 O que lá vai

# Tom de voz

## Três pares — é X, não Y
- Directo, não abrupto. Dizemos o preço na primeira frase;
  não dizemos «recusado» sem explicar.
- Calmo, não entusiasmado. Sem pontos de exclamação.
- Técnico quando é preciso, não condescendente.
  Dizemos «chave de API»; não dizemos «aquela coisa secreta».

## Registo por momento
| Momento | Registo |
| Boas-vindas | calor, alguma leveza |
| Meio de tarefa | neutro e curto |
| Erro | sóbrio, prestável, sem piadas |
| Falha grave | sério e específico, sem emoji |

## Vinte palavras
| Usamos | Não usamos | Porquê |
| espaço de trabalho | workspace, organização | é o que os clientes dizem |
| convidar | adicionar utilizador | o convidado tem de aceitar |
| arquivar | apagar | arquivar é reversível |

## Nunca
- Nunca «Ups!» nem «Alguma coisa correu mal».
- Nunca culpabilizar quem recusa («prefiro pagar mais caro»).
- Nunca usar passado em mensagens de acção.

É a estrutura de UX Writing, capítulo 8, convertida em instrução. A terceira coluna do glossário — o porquê — é a que faz a skill sobreviver: sem ela, a decisão é rediscutida de seis em seis meses.

5.3 A skill de comunicações internas

A Anthropic publica internal-comms, para escrever comunicações internas nos formatos que a empresa usa — relatórios de estado, actualizações para liderança, boletins, perguntas frequentes, relatos de incidente. Tem cerca de trinta linhas.

5.4 Verificar tom, e não só escrever

O uso menos óbvio e dos mais úteis: uma skill que revê texto alheio contra o tom de voz.

## Ao rever texto público
1. Procure as palavras da coluna «não usamos» — liste todas.
2. Verifique o registo contra a tabela de momentos.
3. Procure pontos de exclamação e emoji fora de contexto permitido.
4. Confirme que cada mensagem de erro tem as três partes.
5. Devolva uma lista de correcções concretas, não uma
   apreciação geral. «Substituir X por Y na linha N.»

O passo 5 é o que a torna utilizável: uma revisão que devolve «o tom podia ser mais consistente» não produz nenhuma alteração.

6.1 O mapa de risco

6.2 O que as skills oficiais de arte impõem, e porquê

6.3 A arte algorítmica é o caso mais interessante

algorithmic-art tem cerca de 400 linhas e cobre aleatoriedade com semente e exploração interactiva de parâmetros. O detalhe que a torna um bom modelo é a semente:

• Reprodutível. A mesma semente dá a mesma peça — pode-se voltar atrás, versionar e iterar.
• Explorável. Variar parâmetros produz uma família coerente em vez de peças soltas.
• A obra é o código, não o resultado — o que resolve boa parte da questão de autoria do capítulo 4.1.

É o caso em que gerar é a resposta certa, e vale a pena reparar porquê: o resultado é determinístico dado um parâmetro, e portanto controlável.

6.4 A instrução obrigatória em qualquer skill de peça visual

## Sempre
- Use apenas os valores da skill `identidade-visual`.
- Verifique contraste de todo o texto sobre o fundo real.
- Declare no fim que elementos foram gerados e quais vieram
  de recursos da marca.

## Nunca
- Nunca imite o estilo de um artista ou marca identificável.
- Nunca use uma imagem de origem desconhecida.
- Nunca gere um logótipo ou símbolo de identidade —
  ver `identidade-visual` para os ficheiros aprovados.

A última proibição é a que mais estragos evita: impede que uma skill de peça produza, por conveniência, uma variante do logótipo — que é como as identidades se degradam.

7.1 O que a skill faz aqui

Não decide. Garante que as perguntas certas são feitas, sempre, e que ninguém salta a que dá jeito saltar. É a skill de procedimento aplicada a uma conversa:

# Descoberta de marca — não avançar sem respostas

## Sobre o negócio
1. Que problema resolve, na linguagem de quem o tem?
2. O que acontece a um cliente se vocês fecharem amanhã?
3. Qual é a decisão que o cliente toma antes de comprar?

## Sobre a categoria
4. Nomeie cinco concorrentes. Que cor usa cada um?
5. O que é convenção na categoria — e é obrigatório segui-la?
6. Onde é que todos dizem a mesma coisa?

## Sobre a aplicação
7. Onde é que isto vai aparecer? Liste os cinco sítios mais frequentes.
8. Qual é o pior meio de reprodução previsto?
9. Vai ser bordado, gravado, impresso a uma cor, reduzido a 16px?

## Sobre restrições
10. Há registo de marca a considerar? Alguma cor está tomada?

Se as perguntas 4 e 8 não tiverem resposta, pare.
São as duas que determinam se a identidade se distingue e se sobrevive.

7.2 Porque as perguntas 4 e 8

7.3 Da descoberta às direcções

Com as respostas, o passo seguinte é onde a máquina de opções é útil: gerar direcções nomeadas por atributo, cada uma com a justificação a apontar para uma resposta concreta da descoberta.

## Cada direcção tem de trazer
- Um nome de atributo, não de gosto: «denso e tipográfico»,
  não «moderno» nem «clean».
- A resposta da descoberta que a justifica.
  «Vai para verde-azulado porque os cinco concorrentes são azuis (P4).»
- O que sacrifica. Toda a direcção sacrifica alguma coisa.
- Como se comporta no pior meio da pergunta 8.

Produza cinco direcções. Nunca menos de três — com duas,
a escolha é binária e a discussão vira gosto.

7.4 A skill que critica em vez de propor

## Ao avaliar uma direcção de marca
Responda a cada uma, com sim/não e a razão:
1. Distingue-se dos cinco concorrentes da descoberta?
2. Sobrevive ao pior meio da pergunta 8?
3. Funciona em escala de cinzentos?
4. A cor escolhida está tomada na categoria?
5. O que é que esta direcção impede de fazer depois?

Não sugira alterações. Só aponte falhas — quem decide é quem
tem o contexto que não está aqui.

8.1 Os cinco

8.2 A segunda é a que define o domínio

## Restrições de direcção
- Não azul: cinco concorrentes já o usam (P4 da descoberta).
- Não geométrica sem serifa: é a escolha por omissão da categoria.
- Não gradiente, não sombra suave, não cantos a 8px.
- A identidade tem de funcionar a uma cor, bordada. Comece por aí.

8.3 A terceira, e como se mede

A deriva de identidade é lenta e invisível peça a peça. Mede-se assim: corra o varredor de intrusos (cap. 3.4) sobre todas as peças dos últimos seis meses e conte os valores fora da paleta. O número diz o estado da disciplina — e repetido trimestralmente diz se está a melhorar.

8.4 O que não delegar, em nenhum caso

• A decisão de posicionamento. Exige saber o que os concorrentes fazem e o que o público valoriza. É pesquisa (Pesquisa com Utilizadores).
• A aprovação final de um símbolo. Questão de autoria e de exclusividade (cap. 4.1).
• O julgamento sobre apropriação cultural de um símbolo ou de uma cor. Exige contexto que não está em texto.
• A decisão de mudar uma identidade estabelecida. É de negócio, e o custo é a contagem de consistência que recomeça (Cor, secção 5.8, caso 1).

10.1 O problema

Uma agência tem dez identidades diferentes. Uma skill por cliente significa dez descrições permanentemente em contexto, todas parecidas, todas a competir — é o cenário exacto que degrada a activação (volume II, cap. 8.4).

10.2 A estrutura que funciona

skills/
├── identidade/              # UMA skill, não dez
│   ├── SKILL.md             # o método: como se aplica uma identidade
│   └── references/
│       ├── cliente-a.md     # tabela de valores do cliente A
│       ├── cliente-b.md
│       └── ...
└── verificar-peca/
    ├── SKILL.md
    └── scripts/verificar.py # recebe o cliente como argumento

# SKILL.md de identidade/
description: Aplica a identidade visual do cliente a qualquer peça.
  Use sempre que produzir material para um cliente. Pergunte qual é o
  cliente se não for evidente e leia references/<cliente>.md antes
  de qualquer decisão visual.

## Sempre
1. Identificar o cliente. Se não for claro, PERGUNTE. Nunca presuma.
2. Ler `references/<cliente>.md` — inteiro, antes de produzir.
3. Usar apenas os valores desse ficheiro.
4. Verificar com `verificar-peca` indicando o cliente.

## Nunca
- Nunca misturar valores de dois clientes na mesma peça.
- Nunca usar valores de memória de um projeto anterior.

10.3 O ficheiro de cliente

Cada references/<cliente>.md tem a mesma estrutura — o que permite ao script de verificação lê-los todos:

# Cliente A

## Cores
| token | valor | contraste vs fundo | uso |
| fundo | #FAF6EF | — | superfícies |
| tinta | #1E1912 | 16,2:1 | texto |
| acento | #932E14 | 7,4:1 | destaques, máx. 10% |

## Tipos
Títulos: X 600. Corpo: Y 400.

## Logótipo
`assets/cliente-a/` — versões: positivo, negativo, mono, favicon.
Área de protecção: 0,5× altura do símbolo.

## Proibições específicas
- Nunca sobre fotografia sem caixa sólida.
- O verde #2E5B3A é do concorrente principal. Nunca usar.

## Última revisão: 2026-08-14 · dono: [nome]

As duas últimas linhas são o que impede a skill de apodrecer: data e dono (volume I, cap. 8.4).

10.4 O que isto dá de graça

• Entra um cliente novo — acrescenta-se um ficheiro, não uma skill.
• Muda uma identidade — muda-se um ficheiro, e propaga-se a tudo.
• É documentação para pessoas, na mesma pasta e no mesmo formato.
• O script de verificação serve todos, porque a estrutura é igual.

11.1 A ordem

As duas primeiras resolvem a maior parte da deriva e escrevem-se numa manhã. As outras três acrescentam conforme o tipo de trabalho.

11.2 Como saber que está a resultar

• Menos correcções de cor e tipo em revisão. O indicador mais directo.
• O varredor de intrusos devolve menos. Mensurável, e comparável trimestre a trimestre (cap. 8.3).
• Peças de pessoas diferentes parecem da mesma casa. É o objectivo, e nota-se.
• E o contra-indicador: se a skill de identidade não mudou em seis meses, ou a marca está estável ou ninguém a mantém.

12.1 As sete regras

12.2 Catálogo: cinco skills para marca e identidade

12.3 Leituras a par

• Skills I, II e III.
• Branding — o critério que estas skills executam.
• Cor — paletas, contraste e as cinco paletas prontas da secção 4.7.
• Logótipos & Lettering — os testes de esforço do capítulo 4.3.
• IA e Identidade Visual — autoria, marca registada e o que se pode registar.
• UX Writing e Microcópia — o tom de voz do capítulo 5.