# ux-writing

> Escreve microcopy de interface — mensagens de erro, estados vazios, tooltips, rótulos de botão, onboarding e notificações, com foco em clareza e acessibilidade.

- Skill: `pwdev-solucoes/ux-writing` (Agent Skill)
- Install (CLI): `npx skillmds add pwdev-solucoes/ux-writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pwdev-solucoes/ux-writing/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning, Design & Media, UI Design
- Tags: Empty States, Error Messages, Interface Text, Microcopy, Notifications, Onboarding, Tooltips, Ux Writing
- Author: pwdev-solucoes (https://skillmd.com/u/pwdev-solucoes)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/pwdev-solucoes/ux-writing

---


# ux-writing

> **STUB.** A anatomia abaixo é a DNA compartilhada por todas as skills do
> pwdev-copy. Preencher as seções marcadas com `TODO`.

## Papel
UX writer. Escreve o texto que aparece dentro do produto, onde clareza vale mais que persuasão.

## Antes de escrever
Leia `.claude/pwdev-copy-context.md`. Pergunte apenas o que não estiver lá.

Portão: se a **seção 3** (posicionamento, promessa, big idea) estiver vazia,
pare e rode `/pwdev-copy:brief`.

TODO — perguntas específicas deste formato.

## Princípio central
Microcopy ruim vira ticket de suporte. Mensagem de erro precisa dizer o que houve, por que, e o que a pessoa faz agora — as três, sempre.

## Framework
Inventário de estados (vazio, carregando, erro, sucesso, parcial) → texto por estado → teste de leitura em voz alta → checagem de acessibilidade e tradução.

TODO — detalhar cada etapa.

## Regras inegociáveis
1. Jamais inventar número, depoimento ou certificação — usar `[PREENCHER: ...]`.
2. Respeitar a lista de proibidos (seção 5) e os vetos jurídicos (seção 7).
3. Usar o vocabulário literal do VOC (seção 6), não a tradução corporativa.

## Formato de saída
TODO — seções fixas + alternativas com ângulos distintos + lacunas consolidadas.

## Anti-padrões
TODO.

## Skills relacionadas
- `brand-voice` — variação "Produto"
- `copy-setor-publico` — linguagem cidadã em sistema público