O que são Habilidades de Agente e como utilizá-las

TL;DR

• As Habilidades de Agente são um padrão aberto para empacotar fluxos de trabalho reutilizáveis, expertise de domínio e novas capacidades em pastas portáteis que qualquer agente de IA pode descobrir e usar — pense nelas como "prompts salvos" em alta potência
• As habilidades usam um modelo de divulgação progressiva em três níveis para proteger a janela de contexto: apenas o nome e a descrição são carregados na inicialização (~30-50 tokens por habilidade), o arquivo completo SKILL.md é carregado quando acionado, e arquivos de referência são carregados apenas quando necessários durante a execução
• Originalmente criadas pela Anthropic, as habilidades agora são um padrão aberto em agentskills.io, adotado por mais de 26 plataformas, incluindo Claude, OpenAI Codex, Gemini CLI, GitHub Copilot, Cursor e VS Code
• Uma habilidade é apenas uma pasta com um arquivo SKILL.md (YAML frontmatter + instruções em markdown) mais diretórios opcionais scripts/, references/ e assets/ — você pode construir uma em minutos
• As habilidades são compostáveis: combine habilidades personalizadas com habilidades de documento integradas e servidores MCP para construir fluxos de trabalho complexos e previsíveis que produzem resultados consistentes toda vez

O Que São Habilidades de Agente?

Se você se pega digitando o mesmo prompt em várias conversas — um formato de relatório semanal, uma lista de verificação de revisão de código, um pipeline de análise de dados — você já sentiu o problema que as habilidades resolvem. As Habilidades de Agente são pastas de instruções que empacotam fluxos de trabalho repetidos, conhecimento especializado ou novas capacidades para o seu agente de IA. Em vez de copiar e colar prompts longos a cada sessão, você os escreve uma vez como uma habilidade e os reutiliza em cada conversa.

Mas as habilidades vão muito além de "prompts salvos." Elas são um padrão aberto originalmente criado pela Anthropic e agora governado como uma especificação multiplataforma em agentskills.io.

Em 18 de dezembro de 2025, a Anthropic lançou as Habilidades de Agente como um padrão aberto, publicando a especificação e o SDK para qualquer plataforma de IA adotar. Isso significa que uma habilidade que você constrói para Claude funciona de forma idêntica no OpenAI Codex, Gemini CLI, GitHub Copilot, Cursor, VS Code e mais de 20 outras plataformas que adotaram o padrão.

A maneira mais simples de pensar sobre isso: O MCP dá ao seu agente acesso a ferramentas e dados externos. As habilidades ensinam ao seu agente o que fazer com essas ferramentas e dados.

• Sistema de Arquivos (esquerda) — Habilidades que fornecem instruções e conhecimento de domínio ao agente
• Agente (centro) — Contém o LLM e as Ferramentas trabalhando juntas
• Servidores MCP (direita) — Conexões externas de ferramentas e dados
• Subagentes (parte inferior) — Criados pelo agente principal para trabalho paralelo/especializado

As habilidades fluem para o agente como conhecimento, o MCP conecta-se bidirecionalmente para capacidades externas, e os Subagentes são despachados a partir do agente. Isso reforça visualmente o ponto: O MCP dá ao seu agente acesso a ferramentas e dados externos. As habilidades ensinam ao seu agente o que fazer com essas ferramentas e dados.

Por Que as Habilidades Importam: De Prompts a Pacotes

O Problema da Repetição de Prompts

Considere um criador de conteúdo que publica postagens de blog toda semana. Sem habilidades, cada conversa começa da mesma maneira:

1. Colar as regras da estrutura do post do blog (seção TL;DR, hierarquia de cabeçalhos, formato de citações)
2. Colar as diretrizes de SEO (densidade de palavras-chave, formato de descrição meta, regras de links internos)
3. Colar as instruções de voz da marca (tom, público, preferências de formatação)
4. Colar ou descrever o tópico e o material de origem
5. Esperar que a saída siga realmente todas essas regras de forma consistente

Agora multiplique isso por uma equipe de cinco escritores, cada um com sua própria versão ligeiramente diferente dessas instruções. A qualidade da saída varia de sessão para sessão e de pessoa para pessoa.

Essa abordagem tem três problemas fundamentais:

• Poluição da janela de contexto — Cada peça de instrução que você cola consome tokens que poderiam ser usados para conteúdo real. Quanto mais instruções você carrega no início, mais rápido sua janela de contexto se enche e maior a probabilidade de degradação na qualidade da resposta
• Sem portabilidade — Seu fluxo de trabalho vive na sua área de transferência ou em um documento compartilhado em algum lugar, não em um artefato versionado e compartilhável que pode ser instalado e usado de forma consistente
• Sem consistência — Sem um formato padronizado, diferentes pessoas interpretarão e colarão essas instruções de maneira diferente, e você nunca pode garantir que o agente siga todas as regras toda vez

Como as Habilidades Resolvem Isso

As habilidades abordam todos os três problemas:

• Divulgação progressiva — Apenas o nome e a descrição da habilidade são carregados na inicialização (aproximadamente 30-50 tokens por habilidade). As instruções completas são carregadas apenas quando a habilidade é acionada. Arquivos, scripts e ativos referenciados são carregados apenas quando necessários durante a execução. Você pode ter centenas de habilidades instaladas sem impacto no desempenho
• Portabilidade — Uma habilidade é uma pasta. Compartilhe-a como um arquivo zip, envie-a para um repositório Git ou publique-a em um marketplace. Como é um padrão aberto, funciona em Claude, Codex, Gemini CLI e em todas as outras plataformas que suportam a especificação
• Repetibilidade — As mesmas instruções são executadas da mesma maneira toda vez, para cada membro da equipe, em todas as plataformas. Em um sistema não determinístico onde você nunca pode prever totalmente a saída do modelo, as habilidades fornecem a estrutura para tornar os fluxos de trabalho o mais previsíveis possível

A Anthropic enquadra a janela de contexto como um bem público — o