Uma skill é uma receita reutilizável que ensina um agente de IA a fazer uma tarefa específica: instruções empacotadas e, às vezes, arquivos ou scripts de apoio. O agente não lê a skill o tempo todo: vê o nome e a descrição, e carrega quando a tarefa combina. Estar instalada não quer dizer que ela seja usada.
📝Sua tarefa→🔎A descrição combina?→📖Carrega a skill→📋Procure a evidência
Teste o que aprendeu
Uma pergunta do app. Escolha uma resposta.
Como você sabe se o agente usou a skill?
Estar instalada só diz que estava disponível. Não prova que foi aberta.
Muitas ferramentas mostram quando carregam uma skill. E o trabalho deveria seguir os passos dela.
Parecer seguro não prova nada. A prova está no que ele fez.
As instruções ficam em um arquivo SKILL.md, com um nome e uma descrição. Algumas skills somam arquivos de apoio, como um modelo ou um exemplo, e scripts para o que precisa sair exato sempre igual. Onde se instalam e como se ativam muda conforme a ferramenta.
Uma skill não é a mesma coisa que MCP. O MCP conecta o agente a ferramentas e dados de fora; uma skill ensina como fazer algo. Também não é o arquivo de regras do seu projeto: essas regras orientam todo o trabalho, e a skill serve para uma tarefa pontual.
Como decide usar: a descrição
Carregar todas as receitas em cada tarefa seria muito texto e ocuparia a janela de contexto sem necessidade. Por isso o agente primeiro vê um resumo, o nome e a descrição, e só carrega o SKILL.md quando acha que a tarefa pede. Os arquivos de apoio ele consulta quando fazem falta.
Um exemplo: você monta uma skill para revisar textos em português do Brasil para uma loja que vende no país todo. Se a descrição diz só "ajuda com textos", o agente pode passar reto. Se diz "revisa textos para clientes em português do Brasil: use antes de publicar a página de um produto", é mais provável que ele escolha bem ali. Se for ampla demais, pode se meter onde não deve.
Instalada não é usada
Uma skill estar instalada só diz que está disponível. Se você pede "conserte este bug" e tem uma skill para escrever testes, o agente pode nem abrir. Se quer que ele use de qualquer jeito, peça pelo nome no seu prompt.
E depois, confira. Muitas ferramentas mostram quando carregam uma skill, e o trabalho deveria seguir os passos dela. A resposta soar segura não prova nada: a prova está no que o agente fez.
Erros comuns
"Se eu instalei, ele vai usar." Nem sempre: depende da tarefa e da descrição. "Com uma boa descrição, ele usa com certeza." Ajuda, não garante. "Uma skill conecta o agente aos meus dados." Isso é mais parecido com MCP: a skill é a receita, não a conexão.