Marcus Andrey Estudo
Read in English Biblioteca

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.md com 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

  1. 1Escolher

    Uma tarefa frequente com um "jeito certo" combinado.

  2. 2Escrever

    Descrição, passos, saída, regras.

  3. 3Testar à mão

    Alguém segue sem te perguntar nada.

  4. 4Instalar

    Na ferramenta que você usa.

  5. 5Conferir

    Cinco casos antigos; mude uma coisa; repita.

A sua primeira skill em cinco passos. Diagrama: Marcus Andrey, CC BY 4.0.

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.md com menos de umas 500 linhas. Coloque referências longas em uma pasta references/ ao lado dele.

Para baixar: esta skill em zip, pronta para enviar (pasta error-microcopy/ com o SKILL.md) · só o SKILL.md.

Uma ficha de receita de bolo inglês datilografada, com os ingredientes e os passos em ordem.
Uma ficha de receita é uma skill no papel: um nome, os ingredientes, os passos em ordem e o aviso que importa. Qualquer pessoa segue sem perguntar a quem cozinha. Foto: SJGW, Wikimedia Commons, CC BY-SA 4.0.

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

AppClaude (claude.ai)

Envie um zip em Customize → Skills.

Todos os planos; execução de código ligada
PastaClaude Code

~/.claude/skills/<nome>/

Carrega pela descrição ou por /nome
PastaChatGPT desktop e Codex

~/.agents/skills/<nome>/

Confira o seu plano
PastaGitHub Copilot

~/.copilot/skills ou .github/skills

Pessoal ou por projeto
PastaCursor

~/.cursor/skills (também lê ~/.claude/skills)

Pessoal
Onde a mesma pasta de skill fica em cada ferramenta, em novembro de 2026. Diagrama: Marcus Andrey, CC BY 4.0.
  • 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/skills ou a pasta .github/skills de 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

  1. Escolha uma tarefa que você repetiu este mês.
  2. Escreva o SKILL.md dela, usando o exemplo da seção 3 como modelo.
  3. Teste à mão com um colega (seção 4).
  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

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

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar