# Skills e instruções reutilizáveis

Curso da DNACX (IA by DNACX). Mini curso de 30 minutos, nível operar, na prateleira "Operação".

- Você sai com: Uma skill sua criada, testada e com o escopo certo, e o critério para decidir entre pedido guardado, projeto e skill
- Ferramentas: Claude · gratuito (testado: criar, salvar, usar e desativar uma skill)
- Antes de começar, faça: Contexto permanente, Sua biblioteca de pedidos
- Testado: Testado em 27/10/2026 em Claude gratuito (criar, salvar, usar e desativar uma skill); página oficial de Skills lida em 27/10/2026.
- Reconferir até 25/01/2027
- Página: https://dnacx.online/ia/cursos/skills-e-instrucoes-reutilizaveis

## Antes de começar

Uma **skill** é um conjunto de instruções (e, às vezes, arquivos) que o Claude carrega quando a tarefa pede. A página oficial de Skills (support.claude.com) a descreve como pastas de instruções, scripts e recursos que o Claude carrega quando a tarefa combina, para Free, Pro, Max, Team e Enterprise, e diz que exige execução de código ativada.

**Privacidade:** não coloque dado de cliente, senha ou documento sigiloso em uma skill (“Segurança, dados e custo”).

## Aula 1 · Três níveis de instrução reutilizável (5 min)

1. **Pedido guardado** (“Sua biblioteca de pedidos”): um texto seu, que você cola. Serve para uma pessoa.
2. **Projeto** (“Contexto permanente”): instruções fixas, aplicadas em toda conversa dentro dele.
3. **Skill:** um pacote que o Claude usa **sozinho** quando a tarefa combina com a descrição dela.

Comece pelo mais simples e suba só se repetir muito.

## Aula 2 · Crie uma skill com o Claude (10 min)

Caminho testado em 27/10/2026 no Claude gratuito:

1. No menu lateral, **Personalização**, aba **Skills**.
2. Clique em **Adicionar** e escolha **Criar com o Claude**.
3. Abre uma conversa nova com um pedido **em inglês** já preenchido ("Let's create a skill together using your skill-creator skill..."). Envie. O Claude responde em inglês e pergunta o que a skill deve fazer.
4. Descreva a skill **em português** e peça "responda em português". Diga o nome, quando ela atua, o que deve fazer e o formato da saída. Texto testado (negócio fictício):

`Responda em português. A skill se chama resposta-de-atendimento. Quando eu colar uma reclamação de cliente de uma loja de roupas online fictícia, ela escreve a resposta em até 4 linhas, em tom próximo e direto, aplicando só esta política: troca ou reembolso em até 7 dias com o produto em mãos, frete da devolução por nossa conta em caso de defeito. Nunca inventa estoque, prazo, desconto ou regra; onde faltar informação escreve [informar]. O resultado é só texto no chat. Pode criar a skill direto, sem mais perguntas.`

5. O Claude criou um arquivo `resposta-de-atendimento.skill` e avisou **duas decisões dele** (pedir a data de recebimento; não prometer frete se o defeito não estiver claro). Como o pedido dizia "criar direto", **o Claude não rodou casos de teste**.
6. No cartão do arquivo, clique em **Salvar Skill**.

## Aula 3 · Confira onde ficou e teste (10 min)

1. **Personalização, Skills, aba Meus.** A skill aparece em "Criado por você", com uma descrição que o Claude escreveu e o botão **Desativar**.
2. **Leia a descrição.** A descrição gerada no nosso teste ficou **ampla**: "use sempre que o usuário colar ou descrever uma reclamação... mesmo que não mencione a skill pelo nome". Se preferir que a skill atue em menos situações, estreite a descrição ou desative.
3. **Teste em conversa nova, sem contexto:** `Responde esse cliente: 'Comprei um vestido e chegou com defeito. Quero meu dinheiro de volta.'`
4. Resultado: o Claude mostrou o passo **"Ler a skill de resposta de atendimento antes de responder, SKILL.md"** e respondeu em 3 linhas, citando os 7 dias com a peça em mãos e o frete da devolução por conta da loja, e pedindo número do pedido, data e foto. O "[informar]" ficou no fim da última frase.
5. **Compare com o seu pedido guardado** (“Sua biblioteca de pedidos”): a skill acertou o que o pedido acerta? Errou o que o pedido não erra?

## Aula 4 · Desative o que você não usa (5 min)

Na aba **Meus**, o botão **Desativar** vira **Ativar**. Skills de terceiros, no **Descobrir**, trazem botões **Testar** e **Adicionar**: antes de adicionar, **leia a descrição inteira** e prefira as da Anthropic ou de fonte que você conhece (orientação do curso).

## Prática (a executar por você)

1. Escolha uma tarefa que você repete e que já tenha um pedido guardado que funciona.
2. Crie a skill pela Aula 2, com o nome, o gatilho e o formato da saída.
3. Teste com 2 casos fictícios que a skill deve atender e compare com o resultado do seu pedido guardado.
4. Estreite a descrição se preferir e desative o que não vai usar.

## Checklist

- [ ] Descrevi a skill em português e disse o gatilho e o formato da saída.
- [ ] Li a descrição que o Claude gerou.
- [ ] Testei com dois casos fictícios.
- [ ] Desativei o que não uso.

## Como testamos

| Passo | Conta | Resultado |
| --- | --- | --- |
| Criar com o Claude, salvar, ver em Meus | Claude gratuito | Funcionou |
| Usar a skill em conversa nova | Claude gratuito | A skill foi lida e aplicada |
| Desativar | Claude gratuito | Botão virou "Ativar" |

## Fontes

Testes da DNACX em 27/10/2026. Página oficial "What are Skills?" (support.claude.com/en/articles/12512176-what-are-skills), lida em 27/10/2026.