Como as skills funcionam e quais os seus tipos?

Skills são instruções previamente formatadas que subimos no sistema para ele responder com mais precisão

Redator: Heitor Augusto Colli Trebien

Como funcionam as skills na prática?

Segundo o Claude API (2026), as skills são mais completas do que os prompts (comandos). Elas funcionam como um arquivo completo contendo uma instrução ou guia detalhados de como se deve agir em certo contexto.

Esse guia contém, principalmente, linguagem natural, mas pode conter códigos também. É possível integrar linguagem natural e artificial nas instruções do guia, permitindo uma contextualização avançada da competência desenvolvida.

Assim, desenvolver uma habilidade ou competência em sua IA é mais fácil, já que você pode criá-la a partir de linguagem natural.

Um exemplo prático seria criar uma habilidade ou competência (skill) de cadastramento. Você escreve um guia, um manual instrutivo, com o passo a passo do processo. Sempre que uma pessoa tiver alguma dúvida sobre cadastramento, será acionada essa skill de cadastro que irá responder e gerar linguagem conforme o passo a passo fornecido.

Tipos de skills

Conforme o Claude API (2026), existem três tipos de conteúdos para criar as habilidades (skills):

1. Metadado: o tipo de conteúdo refere-se às instruções, que neste caso, já estão previamente formatadas, como por exemplo:
   1. Nome: Cadastramento
   2. Descrição: use essa skill sempre que o usuário tiver dúvidas sobre o processo de inscrição ou cadastramento na plataforma. Sempre que a pessoa mencionar a palavra inscrição, cadastramento ou palavras derivativas similares, como cadastro, inscrever-se, etc., responda com base nas informações fornecidas.
2. Instruções: neste caso, as skills são acionadas por meio de linguagem natural. Aqui, as instruções estão mais desenvolvidas do que no primeiro. Caso haja semelhança entre o que o usuário pediu e as instruções fornecidas, o sistema lê a solicitação como dentro do processamento da skill. Exemplo:
   1. Seu nome é Vel, você é atendente virtual da Velip e seu trabalho é orientar o processo de cadastramento pelo site da Velip. Para se cadastrar, o cliente deve:
      1. Entrar no website www.velip.com.br, acessar a página de contato e preencher o formulário disponibilizado na página.
      2. Ou deve falar pelo WhatsApp, através do número 11 3557-4600, com um especialista humano para realizar o cadastro.
3. Códigos e recursos: são carregados apenas quando necessários. Envolvem as instruções, códigos e recursos ou materiais adicionais. Por exemplo, quando se pede um vídeo para entender como o cadastramento é feito, ou sobre como preencher o formulário, a resposta pode conter um vídeo mostrando o passo a passo. A própria IA pode utilizar esse material extra para ajudar no processo de elaboração da resposta.

Arquitetura das skills

Como a Claude API (2026) explica, as skills (competências/habilidades) rodam em um ambiente de execução de dados, dos quais podem acessar arquivos e comandos bash.

Comandos bash são instruções ou scripts digitados em sistemas Linux, macOS ou Unix para executar tarefas como: criar arquivos, mover pastas, instalar programas e outras ações que fazemos no dia a dia.

Ou seja, as skills também nos ajudam a automatizar tarefas com mais qualidade no dia a dia, principalmente para aquelas que exigem um manual de instrução.

Como um sistema acessa as skills?

Para acessar competências ou habilidades, o programa também utiliza comando bash para puxar a skill do sistema de arquivos, no caso do Claude, o SKILL.md.

No entanto, o comando bash pode puxar outros arquivos, como formulários (FORMS.md). O programa lê mais de um tipo de arquivo para elaborar a resposta, passando por um processo de “reflexão” artificial mais profundo para responder.

No nosso exemplo de uma skill para se cadastrar em uma plataforma, o programa acessa tanto a skill como o formulário de inscrição, gerando uma linguagem muito mais adaptada à necessidade do momento.

Modo de funcionamento na prática

O programa acessa apenas o que precisa no momento. Mesmo que uma Skill tenha muitos arquivos ou muitas páginas de texto, ele carrega somente aquilo que é necessário para executar a tarefa. Isso economiza tokens e deixa o processo mais eficiente.

Os scripts também funcionam de forma inteligente. Quando o programa executa um script, ele não precisa “ler” todo o código dentro da conversa. Apenas o resultado do script é usado, como mensagens de sucesso ou erro. Assim, o uso de contexto fica muito menor.

Por causa disso, uma Skill pode ter bastante conteúdo, como:

• documentação de APIs,
• exemplos,
• bases de dados,
• materiais de apoio.

Tudo isso pode ficar armazenado sem pesar no contexto, desde que não seja utilizado 100% do tempo.

Esse modelo funciona como consultar um manual: o programa acessa apenas a seção necessária para cada tarefa, em vez de carregar tudo de uma vez.

Assim, o sistema fica mais eficiente e inteligente, melhorando a nossa comunicação automatizada do dia a dia empresarial.

Referência

CLAUDE API Docs. Agent Skills. Disponível neste link. Acesso em 25 mai. 2026.