Skills são pacotes de instruções que ensinam um agente de IA a executar uma tarefa específica do jeito certo. Em geral, cada skill fica em uma pasta com um arquivo de texto e, se preciso, scripts e modelos de apoio.

Como funciona

O agente não carrega todas as skills de uma vez. Ele vê uma lista curta com o nome e a descrição de cada uma. Quando a tarefa combina com uma descrição, ele abre a skill completa e segue o passo a passo.

Isso economiza espaço na janela de contexto, porque só entra o que é necessário na hora. O formato exato muda de ferramenta para ferramenta, então confira a documentação da que você usa.

Uma skill costuma ter:

  • Um nome e uma descrição de quando usar.
  • As instruções em Markdown.
  • Arquivos de apoio, como exemplos e scripts.

Exemplo prático

Você tem um jeito fixo de publicar posts no blog da sua empresa: título curto, resumo de até 155 caracteres, imagem de capa e revisão final. Em vez de repetir isso toda vez no prompt, você cria uma skill.

Markdown · skills/publicar-post/SKILL.md
---
name: publicar-post
description: Use quando for publicar um post no blog.
---

1. Escreva o título com até 60 caracteres.
2. Crie um resumo de até 155 caracteres.
3. Confira a imagem de capa antes de publicar.

Agora, sempre que você pedir um post, o agente encontra a skill e segue o processo.

Para que serve

As skills servem para:

  • Padronizar tarefas repetidas, como revisar código, escrever documentos ou rodar deploys.
  • Compartilhar o jeito de trabalhar da equipe sem depender de cada pessoa lembrar tudo.
  • Manter o prompt principal curto, deixando detalhes para quando forem preciso.

Em fluxos com vários agentes, como os que o bridgecode orquestra, cada agente pode usar as skills certas para o seu papel.

Cuidados

Uma skill é instrução que o agente vai seguir, e pode incluir scripts. Use apenas skills de fontes confiáveis e leia o conteúdo antes de instalar, pois uma skill maliciosa pode induzir o agente a fazer algo indevido.

Diferença entre skills e AGENTS.md

O AGENTS.md traz regras gerais do projeto, lidas desde o início. As skills tratam de tarefas específicas e só são abertas quando necessárias. Os dois se complementam: regras gerais num arquivo, procedimentos especializados em skills.