#001 · Skills
Prompt que você repete vira skill
Uma skill é um conjunto de instruções guardado num arquivo, que o agente carrega quando a tarefa pede. Ela fica numa pasta dentro de .agents/skills/ no projeto, ou em ~/.agents/skills/ para valer em todos.
Como criar
Crie a pasta com o nome da skill e, dentro dela, um SKILL.md:
.agents/skills/resumo-semanal/SKILL.md
---
name: resumo-semanal
description: Resume as anotações da semana em um e-mail curto para o time. Use quando pedirem o resumo semanal.
---
Leia as anotações da pasta notas/ dos últimos 7 dias.
Escreva um e-mail de no máximo 8 linhas com o que foi entregue,
o que travou e o que vem na próxima semana.
Tom direto, sem jargão.
Depois, é só pedir: “faz o resumo semanal”.
O que importa na descrição
A descrição decide quando a skill entra. Diga o que ela faz e quando usar, com as palavras que você usaria para pedir. Descrição vaga, skill que nunca é chamada.
Quando não vale
Prompt usado uma vez não precisa virar skill. Regra prática: na terceira vez que colar o mesmo texto, ele vira arquivo.
Perguntas frequentes
Skill é a mesma coisa que prompt de sistema?
Não. O prompt de sistema vale para a conversa inteira. A skill só entra quando a tarefa combina com a descrição dela, então dá para ter várias sem pesar no contexto.
Funciona em qualquer agente?
O nome da pasta e o formato podem mudar de uma ferramenta para outra. O princípio é o mesmo: instrução fixa num arquivo, carregada quando a tarefa pede.