Como usar Agent Skills

As Agent Skills são uma das formas mais eficientes de usar LLMs. Elas fornecem o contexto adequado para a tarefa que você quer realizar de forma repetível. 

E a melhor parte? 

As empresas estão criando essas skills para você, então basta usá-las nos seus workflows. Neste guia, vou mostrar como aproveitar essas skills para criar recursos que realmente funcionam.

O que são Skills?

Uma “Skill” é uma pasta com arquivos markdown que explicam como realizar uma tarefa específica. O arquivo principal da skill deve se chamar SKILL.md, e o conteúdo desse arquivo pode ser o que você quiser, desde que o frontmatter contenha os campos de nome e descrição. (Há outros campos opcionais de frontmatter que você encontra aqui.)

É recomendável que esse arquivo principal SKILL.md tenha menos de 500 linhas.

Nessa pasta, você pode incluir outras informações, que podem ser referenciadas pelo arquivo SKILL.md, mas carregadas no contexto apenas quando apropriado. Essas informações devem ser armazenadas nas seguintes pastas:

1. scripts/ - Código executável que os agentes podem executar.
2. references/ - Mais arquivos markdown que podem ser usados como documentação adicional, quando necessário.
3. assets/ - Recursos estáticos que o agente pode usar.

O que torna as Skills especiais?

Um dos maiores problemas ao usar IA é o Excesso de Contexto. O excesso de contexto acontece quando você fornece tanto contexto (ou seja, informações) à IA que ela tem dificuldade para realizar a tarefa.

Imagine dar a um desenvolvedor júnior a documentação exata de um recurso específico, sem nada irrelevante. Depois de ler essa documentação, ele teria grandes chances de conseguir implementá-lo.

Agora imagine pedir ao desenvolvedor júnior que leia TODA a documentação. Depois, que implemente um recurso específico a partir de uma pequena parte dela. As chances de sucesso seriam muito menores.

Os LLMs se comportam da mesma forma. 

Abordagens anteriores, como o MCP, tentaram resolver isso carregando grandes volumes de contexto estruturado no modelo. Isso funcionava melhor do que não ter contexto algum, mas ainda tinha dificuldade para realizar tarefas de forma consistente.

As Skills são diferentes.

Por padrão, apenas o nome e a descrição do frontmatter são carregados na janela de contexto. Isso ocupa muito pouco contexto, mas informa ao LLM quais tipos de skills estão disponíveis. Quando uma Skill é considerada útil, o arquivo SKILL.md é carregado na janela de contexto. Depois, somente quando necessário, os outros arquivos das pastas scripts/, references/ e assets/ são carregados no contexto.

Então, como usar essas Skills?

skills.sh

Dependendo da interface de LLM que você usa, elas podem ser baixadas e armazenadas nos locais adequados para aquele aplicativo. Por exemplo:

Mais uma vez, Skills são apenas pastas com arquivos, então você pode copiá-las e colá-las nesses diretórios e tudo funcionará.

A outra opção é usar o skills.sh. 

Este é um diretório de Agent Skills criado pela Vercel que permite descobrir Skills com base na frequência de uso. Você também pode usar uma ferramenta de CLI desenvolvida por eles para adicionar essas skills aos seus projetos ou ao seu usuário global.

Para isso, execute o comando npx skills add <owner/repo>, e ele orienta você durante todo o processo. O comando é basicamente um copiar e colar aprimorado, mas mais rápido.

Usando Skills

Depois de instalá-las (usando o skills.sh ou copiando e colando), usá-las é muito simples. O editor que você estiver usando deve automaticamente usar a skill sempre que considerar útil. Em teoria, depois de colocar a skill no local certo, você não precisa mais se preocupar com isso. 

MAS, no momento em que escrevo isto, ele nem sempre usa as Skills nos momentos certos. Então, se você sabe que ele deve usar uma skill em determinado momento, avise o LLM. 

Por exemplo, instalei as skills de Speech to Text da ElevenLabs. Então, se eu quiser que o Claude as use, posso enviar o seguinte prompt:

Use a skill de speech to text para implementar um exemplo simples neste projeto. Use este áudio: https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3.

Ele conseguiu criar o app abaixo de uma só vez.

É claro que essa interface precisa melhorar bastante, mas a lógica central da ElevenLabs está correta e funcionando. Tudo com uma única frase. 

Recomendo muito usar Agent Skills nos seus projetos. Elas dão ao seu LLM o contexto certo para uma tarefa específica, selecionado pelas pessoas que criaram as ferramentas.

E, se você usa a ElevenLabs nos seus projetos, instale nossas skills com:

npx skills add elevenlabs/skills