Alt Text

Texto Alternativo

Você escreve o que a pessoa que não vê a imagem precisa receber.

Princípio central

> Alt text não descreve a imagem. Transmite a informação que a imagem carrega.

Duas peças visualmente idênticas com propósitos diferentes recebem alt texts diferentes.

Regras

Comece pela informação, não pelo meio. ❌ "Imagem de um card com fundo verde mostrando..." ✅ "Fechamento do mês caiu de 11 dias para 20 minutos após a integração."

Leitor de tela já anuncia que é imagem. Repetir gasta o tempo de quem escuta.

Transcreva todo texto da peça. Se há texto na imagem, ele precisa estar no alt. Texto em pixel é invisível para leitor de tela.

Tamanho: 1-2 frases para peça simples; até 4 para card de dado ou infográfico. Sem limite rígido, mas alt longo demais cansa — se precisar de mais, o conteúdo deveria estar na legenda.

Sem "imagem de", "foto de", "gráfico mostrando". Vá direto.

Descreva pessoas com neutralidade. Só mencione característica física se for relevante para a informação. Não infira gênero, idade, etnia ou condição a partir da aparência — se a informação não estiver confirmada, descreva o que a pessoa faz, não o que você supõe que ela é.

Dado precisa do número. "Gráfico de crescimento" é inútil. "Atendimentos subiram de 1.200 para 3.400 entre janeiro e junho de 2026" serve.

Por tipo

| Tipo | O que o alt precisa ter | |---|---| | Quote card | a frase completa + quem disse | | Card de dado | o número, a unidade, o período, a fonte | | Carrossel | um alt por slide, cada um autônomo | | Screenshot de produto | o que a tela mostra e o que isso significa | | Foto de pessoas | a ação e o contexto, sem inferir identidade | | Peça institucional | a informação de serviço completa |

Carrossel

Um alt por slide. Cada um precisa fazer sentido sozinho — a pessoa pode entrar em qualquer slide. É o formato que mais falha em acessibilidade, porque o time escreve um alt só e aplica em todos.

Onde entra

| Plataforma | Onde | |---|---| | Instagram | Configurações avançadas → texto alternativo | | LinkedIn | botão Alt ao anexar | | Facebook | editar texto alternativo | | X | "Adicionar descrição" |

Sempre entregue o alt junto da peça, no mesmo pacote. Alt que chega depois não é aplicado.

Formato de saída

### {{peça}} — alt text
{{texto}}

Caracteres: {{n}}
Texto da peça transcrito: sim | não — {{motivo}}

Limites

• Não escreve legenda de post — ver pwdev-copy
• Não descreve peça que não viu: sem imagem nem spec, peça o material
• Não infere identidade de pessoas a partir de aparência

Skills relacionadas

• creative-review — checa se o alt existe
• export-handoff — leva o alt junto da peça

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: pwdev-solucoes
• Source: pwdev-solucoes/pwdev-claude-marketplace
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.