#001 · Skills

Prompt que você repete vira skill

Por · · 1 min de leitura

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.