IA para UX · Laboratórios · 5 min de leitura
Construa a sua primeira skill
Um laboratório prático: transforme uma tarefa que você repete em uma skill de IA, uma pequena pasta de instruções que o Claude, o ChatGPT, o Copilot, o Cursor e outras ferramentas conseguem carregar. Escreva, teste à mão, instale, confira em trabalhos anteriores e melhore.
Se você já escreveu o mesmo prompt três vezes, está na hora de uma skill. Uma skill é uma pasta com um arquivo de instruções, o
SKILL.md, que diz a uma ferramenta de IA como fazer um tipo de tarefa: os passos, o resultado e as regras. Desde dezembro de 2025 ela é um formato aberto, o Agent Skills, então a mesma pasta funciona em várias ferramentas. Você não precisa programar para escrever uma: é um documento curto e preciso, do tipo que designers escrevem o tempo todo.
O que você vai conseguir fazer depois deste laboratório:
- Escolher uma tarefa que mereça uma skill
- Escrever um
SKILL.mdcom descrição, passos, resultado e regras - Instalar a skill na ferramenta que você usa
- Conferir a skill em trabalhos anteriores e melhorá-la
Os produtos e caminhos estão na situação de novembro de 2026. Para os conceitos (skills, subagentes, conectores, plugins), veja Agentes e skills de UX: um guia para designers.
1. O laboratório em cinco passos
- 1Escolher
Uma tarefa frequente com um "jeito certo" combinado.
- 2Escrever
Descrição, passos, saída, regras.
- 3Testar à mão
Alguém segue sem te perguntar nada.
- 4Instalar
Na ferramenta que você usa.
- 5Conferir
Cinco casos antigos; mude uma coisa; repita.
2. Escolha a tarefa
Uma boa primeira skill é uma tarefa frequente, que tem um "jeito certo" com o qual o seu time já concorda e que produz um resultado em texto que você consegue conferir. Por exemplo:
- Reescrever mensagens de erro técnicas no padrão de microcopy do seu produto.
- Transformar anotações soltas de reunião em um registro de decisão.
- Conferir a descrição de uma tela contra o seu checklist de acessibilidade.
Evite, numa primeira skill: qualquer coisa que poste, publique ou apague, e qualquer coisa com dados pessoais ou confidenciais.
3. Escreva o SKILL.md
O arquivo começa com dois campos obrigatórios e depois traz instruções em texto simples:
---
name: error-microcopy
description: Reescreve mensagens de erro técnicas no nosso padrão de microcopy
de três linhas (título, mensagem, ação). Use quando alguém colar um código de
erro, um stack trace ou uma mensagem bruta do sistema e pedir um texto para o usuário.
---
# De mensagens de erro para microcopy
## Passos
1. Leia o erro técnico e descubra o que aconteceu para a pessoa.
2. Escreva um título de até 5 palavras que diga o que aconteceu, sem culpar ninguém.
3. Escreva uma frase que diga por quê, ou o que continua seguro.
4. Escreva o rótulo de uma ação que comece com um verbo.
## Resultado
Título: …
Mensagem: …
Ação: …
## Regras
- Nunca invente uma causa que o erro não mostra. Se não tiver certeza, diga "Algo deu errado".
- Sem códigos técnicos, sem pontos de exclamação, sem "Ops".
- Se o erro envolver pagamento ou dados pessoais, acrescente: "Confirme com o time de produto antes de publicar."
As regras do formato (especificação):
name: até 64 caracteres, letras minúsculas, números e hífens, e igual ao nome da pasta (error-microcopy/SKILL.md).description: até 1.024 caracteres. Diga o que ela faz e quando usar, com as palavras que as pessoas realmente digitam. É assim que a ferramenta decide carregar a sua skill.- Mantenha o
SKILL.mdcom menos de umas 500 linhas. Coloque referências longas em uma pastareferences/ao lado dele.
Para baixar: esta skill em zip, pronta para enviar (pasta error-microcopy/ com o SKILL.md) · só o SKILL.md.
4. Teste à mão, antes de qualquer IA
Entregue o seu SKILL.md e três entradas reais para um colega. Peça para ele seguir exatamente o que está escrito, sem perguntar nada para você. Onde ele hesitar, a IA vai chutar. Corrija esses pontos.
5. Instale
Envie um zip em Customize → Skills.
Todos os planos; execução de código ligada~/.claude/skills/<nome>/
Carrega pela descrição ou por /nome~/.agents/skills/<nome>/
Confira o seu plano~/.copilot/skills ou .github/skills
Pessoal ou por projeto~/.cursor/skills (também lê ~/.claude/skills)
Pessoal- Claude (claude.ai): disponível em todos os planos, com a execução de código ativada. Compacte a pasta em um zip e envie em Customize → Skills. Nos planos Team e Enterprise, quem administra a organização primeiro ativa as skills nas configurações da organização. O claude.ai rejeita campos de frontmatter que não fazem parte do padrão.
- Claude Code: coloque a pasta em
~/.claude/skills/error-microcopy/. Ela carrega sozinha quando o seu pedido combina com a descrição, ou com/error-microcopy. - Outras ferramentas: o app de desktop do ChatGPT e o Codex leem
~/.agents/skills; o GitHub Copilot lê~/.copilot/skillsou a pasta.github/skillsde um projeto; o Cursor lê~/.cursor/skills(e~/.claude/skills). Confira a documentação de cada ferramenta para o seu plano.
6. Confira em trabalhos anteriores
Rode a skill em cinco casos anteriores em que você já sabe qual é a boa resposta. Para cada um, anote: certo, parcialmente certo, errado, e por quê. Depois mude uma coisa no SKILL.md e rode os cinco de novo. Isso é um eval em miniatura: veja Escreva um conjunto de evals.
7. Erros comuns
- Uma descrição vaga ("ajuda com textos"): a ferramenta nunca carrega a skill.
- Desejos em vez de passos ("seja claro e simpático").
- Nenhum formato de resultado, então cada resposta sai de um jeito.
- Nenhuma regra sobre o que ela nunca deve fazer.
- Compartilhar a skill antes de conferir em trabalhos anteriores.
- Instalar a skill de outra pessoa sem ler todos os arquivos. Veja o checklist de revisão em Agentes e skills de UX: um guia para designers.
8. Vocabulário
| Termo | Significado |
|---|---|
| Skill | Uma pasta de instruções que uma ferramenta de IA carrega para um tipo de tarefa |
SKILL.md |
O arquivo principal da skill: frontmatter mais instruções |
| Frontmatter | O bloco entre as linhas --- no topo, com name e description |
| Agent Skills | O formato aberto de skills, usado por várias ferramentas |
| Referências (references) | Arquivos extras que a skill só lê quando precisa |
9. Experimente
- Escolha uma tarefa que você repetiu este mês.
- Escreva o
SKILL.mddela, usando o exemplo da seção 3 como modelo. - Teste à mão com um colega (seção 4).
- Instale em uma ferramenta e rode em cinco casos anteriores (seção 6).
Perguntas para refletir: o que escrever as regras ensinou sobre o seu próprio processo? Que regra você acrescentaria depois dos cinco casos de teste?
Checklist
Para saber mais
- Formato: Agent Skills · Especificação · Guia rápido
- Ferramentas: Skills do Claude Code · Repositório de skills da Anthropic
Livros, cursos e vídeos para ir mais fundo (em inglês)
Relacionadas
Agentes e skills de UX: um guia para designers · Construindo um roteiro de agentes de IA para o seu time de UX · Padrões de prompt para designers · IA para content design · Escreva um conjunto de evals · Arquivos de contexto