# Alt Text

> Escreve texto alternativo acessível para peças de redes sociais, transmitindo a informação da imagem em vez de descrevê-la, com regras por tipo e formato de saída.

- Skill: `pwdev-solucoes/alt-text` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pwdev-solucoes/alt-text`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pwdev-solucoes/alt-text/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing, Technical Writing
- Tags: Acessibilidade, Alt Text, Leitor De Tela, Redes Sociais
- Author: pwdev-solucoes (https://skillmd.com/u/pwdev-solucoes)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/pwdev-solucoes/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