Uma skill é um pacote reutilizável de instruções que um agente pode aplicar sob demanda. Use skills para procedimentos recorrentes em vários agentes — um guia de estilo da marca, um checklist de revisão de código, um runbook para um fluxo de trabalho específico — em vez de duplicar as instruções no prompt de sistema de cada agente.
Uma skill é um arquivo Markdown com um pequeno cabeçalho de frontmatter:
Os parâmetros de frontmatter mais importantes:
name - identificador em kebab-case.description - breve resumo usado pelo modelo para decidir quando esta skill é relevante. Trate este como o campo mais importante. Seja específico; descrições vagas levam à invocação da skill errada.always-apply - quando true, a skill é incluída em todos os turnos em vez de ser selecionada. Use com moderação; skills com always-apply consomem contexto em todas as mensagens.user-invocable - quando true (o padrão), a skill aparece no pop-up $ para seleção manual.
Você pode agrupar arquivos de suporte junto com a skill — documentação de referência, consultas de exemplo, pequenos scripts — enviando um .zip que contenha o SKILL.md e seus recursos.
Três maneiras de um agente recorrer a uma skill em uma conversa:
- Invocação pelo usuário - pressione
$ no composer e escolha a skill no popover. O conteúdo da skill é pré-carregado para o próximo turno.
- Seleção automática pelo modelo - com base na
description da skill, o agente decide por conta própria quando aplicá-la.
- Always-apply - pré-carregado em todos os turnos para skills configuradas dessa forma.
O painel Skills no console do Cloud permite criar skills diretamente nele, fazer upload de arquivos .md ou .zip e gerenciar quais skills ficam ativas para a sua conta. As skills de sua propriedade ficam ativas por padrão; desative uma para removê-la do popover e do catálogo do modelo sem excluí-la.
As skills podem ser compartilhadas com outros usuários (consulte compartilhamento e acesso).
- Instruções do agente definem o que o agente é e como ele se comporta de modo geral. Ficam sempre ativas para esse agente.
- Skills são situacionais — aplicadas quando relevante e restritas a fluxos de trabalho específicos.
Use uma skill quando o mesmo conjunto de instruções passo a passo continuar aparecendo em vários agentes ou quando você quiser que ela seja acionada apenas para solicitações específicas do usuário, em vez de em todas as interações. Última modificação em 24 de julho de 2026
