O ecossistema de agentes de IA ganhou, em agosto de 2026, duas notícias que parecem a mesma coisa e não são: a Anthropic abriu o formato Agent Skills como padrão livre, e um consórcio de outras cinco empresas — sem a Anthropic — lançou o Agent Plugins 1.0, um formato de pacote pra instalar Skills e MCP em vários clientes de agente de uma vez só. Se você usa Claude Code, a notícia importa especialmente por um motivo chato: o Claude Code não fala esse novo idioma de pacote.

O que aconteceu

Em 6 de agosto de 2026, um consórcio formado por Amazon/AWS, Cursor (Anysphere), Microsoft, OpenAI e Vercel anunciou a Agent Plugins Specification 1.0 — um formato de pacote pensado pra resolver um problema prático: hoje, se você quer que a mesma Skill e o mesmo servidor MCP funcionem em mais de um cliente de agente (Claude Code, VS Code, Cursor, Copilot CLI etc.), cada ferramenta espera uma estrutura de pasta ligeiramente diferente. O Agent Plugins tenta virar o "instalador universal" desse conjunto: uma pasta única, com um manifesto único, instalável em qualquer cliente que declare suporte à spec.

O site oficial do projeto é agent-plugins.org, e o repositório oficial da especificação é github.com/agentplugins/agent-plugins-spec, sob a organização agentplugins no GitHub. O TSC (Technical Steering Committee, o comitê técnico que decide a evolução da spec) lista exatamente as cinco empresas citadas acima; o GitHub aparece como plataforma que deu apoio ao lançamento, mas não como membro fixo do TSC.

Seis dias depois, em 12 de agosto de 2026, o GitHub anunciou disponibilidade geral (GA) do suporte a Agent Plugins 1.0 no VS Code, no Copilot CLI, no GitHub Copilot SDK e no app do Copilot — changelog oficial aqui. Hoje, os clientes que já suportam o formato incluem ChatGPT/Codex, Cursor, GitHub Copilot, Kiro e VS Code.

Agent Skills não é a mesma coisa que Agent Plugins

Essa é a confusão mais fácil de fazer, então vale separar os dois termos antes de continuar:

  • Agent Skills é o formato de arquivo — o SKILL.md com frontmatter (name + description, os dois únicos campos obrigatórios), a pasta com references/ e scripts/ opcionais. Foi desenvolvido originalmente pela Anthropic e depois liberado como padrão aberto — o site agentskills.io descreve isso na seção "Open development": "The Agent Skills format was originally developed by Anthropic, released as an open standard...". Se você já leu o que são Skills da Claude e por que isso muda como você trabalha aqui no site, já conhece essa parte.
  • Agent Plugins é o formato de pacote — uma pasta com manifesto (plugin.json), que pode conter uma ou mais Skills (em skills/<nome>/SKILL.md, o mesmo arquivo do item acima) e a configuração de servidores MCP (em mcp.json). É o "empacotador" que junta Skills e MCP num pacote instalável, não um formato concorrente do SKILL.md — ele reaproveita o SKILL.md como está.

Ou seja: o Agent Plugins não substitui o Agent Skills, ele empacota o Agent Skills junto com MCP dentro de um formato de distribuição comum a vários clientes. É exatamente o par de tecnologias (Skills + MCP) que a gente já explicou junto em montando um agente de verdade: Skills e MCP juntos — o que muda agora é que existe uma tentativa de padronizar como esse par vira um pacote único, instalável em mais de uma ferramenta.

Como é a estrutura de um pacote Agent Plugins

Segundo a especificação publicada em agent-plugins.org/specification, um pacote Agent Plugins válido tem essa forma mínima:

# estrutura mínima de um Agent Plugin (spec 1.0.0)
meu-plugin/
  plugin.json          # manifesto na raiz — obrigatório
  mcp.json             # config de servidores MCP — só na raiz
  skills/
    minha-skill/
      SKILL.md          # mesmo formato Agent Skills de sempre

O plugin.json na raiz precisa ter, no mínimo, o campo $schema apontando pro schema oficial e o campo name:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "meu-plugin",
  "description": "Descrição curta do que o pacote faz.",
  "version": "1.0.0"
}

Um detalhe que a spec deixa explícito e que vale destacar porque é fácil de errar: a configuração de MCP tem que morar em mcp.json na raiz — a spec proíbe declarar isso inline dentro do plugin.json ou em qualquer caminho alternativo. Se você vem de outro ecossistema de plugin onde tudo fica dentro de um manifesto único, esse é o ajuste mental que precisa fazer.

Por que o Claude Code fica de fora

Esse é o ponto que motiva este artigo: o Claude Code usa uma estrutura de plugin diferente e incompatível com a do Agent Plugins 1.0. Pela documentação oficial em code.claude.com/docs/en/plugins (tabela "Plugin structure overview"):

  • O manifesto do Claude Code fica em .claude-plugin/plugin.json — dentro de uma pasta oculta com ponto, não plugin.json solto na raiz.
  • A configuração de MCP fica em .mcp.json — com ponto na frente, não mcp.json.
  • Skills, agents e hooks ficam fora da pasta .claude-plugin/, direto na raiz do plugin (a própria documentação do Claude Code avisa explicitamente contra o erro comum de colocar essas pastas dentro de .claude-plugin/ por engano).

E a Anthropic não participa do consórcio: conferindo o site oficial e o repositório do Agent Plugins, não há nenhuma menção à Anthropic no TSC. Não é uma opinião — é uma ausência que dá pra confirmar direto na fonte.

Na prática, isso quer dizer que um pacote .zip feito seguindo a Agent Plugins Specification 1.0 (com plugin.json e mcp.json soltos na raiz) não instala como plugin no Claude Code sem adaptação — faltam os arquivos com ponto na frente que o Claude Code espera, e vice-versa: um plugin feito pro Claude Code não é reconhecido por um cliente que só entende Agent Plugins 1.0, porque falta o plugin.json (sem ponto) na raiz.

Testamos: dá pra ter os dois manifestos na mesma pasta?

Essa pergunta surgiu naturalmente lendo as duas specs lado a lado: já que os nomes de arquivo são diferentes (.claude-plugin/plugin.json vs. plugin.json, .mcp.json vs. mcp.json) e as duas specs concordam que Skills ficam em skills/<nome>/SKILL.md na raiz do pacote, será que dá pra montar uma única pasta que funciona como plugin nos dois formatos ao mesmo tempo, sem duplicar a Skill?

Isso não está documentado oficialmente em nenhuma das duas specs — nem a Anthropic nem o consórcio do Agent Plugins descrevem esse cenário de "pasta híbrida". A ideia é uma dedução da arquitetura dos dois formatos, não uma recomendação oficial. Ainda assim, valeu testar a parte que dá pra testar sem precisar instalar nada em nenhum app real: montamos, nesta sessão, uma pasta de exemplo com os dois manifestos e uma única pasta skills/ compartilhada:

./.claude-plugin/plugin.json   # manifesto Claude Code
./.mcp.json                    # MCP Claude Code
./plugin.json                  # manifesto Agent Plugins 1.0
./mcp.json                     # MCP Agent Plugins 1.0
./skills/exemplo-dual/SKILL.md # pasta compartilhada pelos dois formatos

Rodamos duas checagens de verdade nesse experimento — a parte que testamos de verdade neste ambiente:

  1. Validação de que os quatro arquivos de manifesto (.claude-plugin/plugin.json, plugin.json, .mcp.json, mcp.json) coexistem na mesma pasta sem colisão de nome e são todos JSON válido — confirmado com node -e "JSON.parse(...)" em cada um.
  2. Validação do SKILL.md compartilhado com o script de checagem de formato Agent Skills deste site (check-skill-md.mjs) — saída OK, com name e description reconhecidos corretamente:
$ node .claude/skills/devpelofuturo-editor/scripts/check-skill-md.mjs skills/exemplo-dual
OK — skills/exemplo-dual/SKILL.md
  name: exemplo-dual
  description: Skill de teste usada só pra validar, no scratchpad da sessão...

O que isso confirma de verdade: na camada de arquivo, os dois formatos não colidem — dá pra ter as duas árvores de manifesto na mesma pasta, e o SKILL.md único é lido como válido pelo formato Agent Skills sem precisar de nenhuma alteração.

O que isso NÃO confirma: se o Claude Code de fato ignora os arquivos plugin.json/mcp.json sem ponto (em vez de dar erro por causa deles) e se um cliente Agent Plugins 1.0 de fato ignora a pasta .claude-plugin/ em vez de travar — isso só dá pra confirmar instalando de verdade no Claude Code e em outro cliente compatível (VS Code, Cursor, Copilot), o que fica fora do escopo desta sessão. Trate a técnica de "manifesto duplo" como hipótese estrutural validada em parte, vale testar na prática, não uma garantia.

Quem precisa se importar agora e quem pode ignorar

Se você distribui uma Skill ou um pacote Skills+MCP só pra usar no Claude Code, nada muda hoje — o Claude Code continua com o próprio formato, documentado e estável. Se você mantém uma Skill que também quer distribuir pra times usando VS Code, Cursor, Copilot ou outro cliente que já suporta Agent Plugins 1.0, vale a pena conhecer a spec agora, porque é um caminho real de distribuição cross-tool que não existia antes — mesmo sem cobrir o Claude Code.

Quem publica ferramentas/integrações pra múltiplos agentes de IA é quem mais ganha com isso: em vez de manter uma estrutura de pasta por cliente, dá pra manter um pacote Agent Plugins e (separadamente) uma adaptação pro formato do Claude Code quando fizer sentido — sem tentar forçar os dois numa solução mágica única, dado que o teste acima só confirma coexistência de arquivo, não instalação garantida.

O que ainda pode mudar

Vale registrar três ressalvas antes de tratar a Agent Plugins Specification 1.0 como algo definitivo:

  • Não existe uma página formal de "GitHub Release 1.0.0" pra essa spec — a versão 1.0.0 vive no próprio conteúdo do repositório (fruto do merge de um PR de publicação da especificação, em julho de 2026), não como uma tag/release separada. Se você for procurar, vai encontrar a versão dentro do texto da spec e do schema, não numa aba de Releases.
  • Já existe rascunho de trabalho da versão 1.1.0 em andamento no repositório oficial (iniciado em 15 de agosto de 2026) — é spec viva, recém-lançada, e o formato do pacote pode ganhar mudanças em pouco tempo. Vale acompanhar o repositório antes de depender fortemente da estrutura atual em produção.
  • A própria comunidade ainda tropeça na estrutura de diretório — há uma issue aberta no repositório oficial (issue #8, "Confusion on Directory rules") discutindo justamente dúvidas de como organizar a árvore de pastas corretamente. Se você ficar em dúvida montando um pacote, não é só você.

Sobre licença: o repositório oficial da especificação usa licença dupla — Apache-2.0 pro código/schemas e CC-BY-4.0 pro texto da especificação em si.

Um aviso à parte: se você buscar por "Agent Plugins" e cair em agentplugins.codes, saiba que esse não é o site oficial — é um guia de terceiros que se declara "not affiliated with the Agent Plugins project or its maintainers" e que ele mesmo aponta de volta pra agent-plugins.org como fonte primária. Não é um site quebrado nem fora do ar, só não é a fonte oficial — use agent-plugins.org e o repositório agentplugins/agent-plugins-spec como referência.

Pra ir mais fundo

Se você ainda não tem familiaridade com o SKILL.md em si (o arquivo que o Agent Plugins empacota), comece por o que são Skills da Claude e por que isso muda como você trabalha. Se você já cria Skills e quer entender como versionar isso de forma mais estruturada usando a API da Anthropic — um caminho diferente do empacotamento em Agent Plugins, mas que resolve um problema parecido (distribuir/atualizar Skill de forma confiável) — vale ler Skills via API: criando, versionando, anexando. E pra ver Skills e MCP funcionando juntos num agente de verdade, antes de pensar em empacotar qualquer coisa, tem montando um agente de verdade: Skills e MCP juntos.

Links oficiais