Hub editorial

Agent Plugins,
sem confundir as camadas

Skill ensina. MCP conecta. Plugin empacota. Marketplace distribui. O cliente executa. Este é o ponto de partida para entender o padrão aberto e escolher o próximo guia sem misturar conceitos diferentes.

Ver compatibilidade Entender o padrão

Mapa mental

Onde cada peça entra?

A confusão diminui quando cada termo recebe uma função. Leia na ordem apresentada: dos componentes até o produto que os executa.

01
Skill
ensina o processo
Instruções e recursos reutilizáveis, geralmente organizados em um SKILL.md.
02
MCP
entrega ferramentas e dados
O protocolo conecta o agente a servidores locais ou remotos.
03
Agent Plugin
empacota os componentes
O envelope portável reúne Skills e configurações MCP em locais previsíveis.
04
Marketplace
distribui o pacote
O catálogo ajuda a encontrar e instalar plugins, mas fica fora do padrão 1.0.0.
05
Cliente
executa e aplica políticas
Cada produto decide instalação, permissões, interface e recursos exclusivos.

Snapshot do padrão

O que vale na versão 1.0.0

Um retrato curto para consulta. Como a especificação ainda se apresenta como Working Draft, confira as fontes oficiais antes de publicar ou automatizar um pacote.

Verificado em 6 ago. 2026

Status: Working Draft
Manifesto: plugin.json
Núcleo portável: Skills + MCP
Fora do escopo: Instalação, runtime, permissões e marketplace

Na verificação de lançamento, VS Code, Cursor, GitHub Copilot, ChatGPT/Codex e Kiro apareciam como clientes compatíveis. O suporte varia por componente e transporte MCP; “compatível” não significa que todos executam tudo do mesmo jeito.

Trilhas de leitura

Qual é a sua dúvida agora?

Não precisa estudar o ecossistema inteiro de uma vez. Escolha a trilha que corresponde à decisão que você precisa tomar.

Entenda01

Comece pelo mapa completo

Veja o problema que o padrão resolve, a estrutura do pacote e os limites da portabilidade.

Ler o artigo-base

Crie02

Domine os dois componentes

Aprenda primeiro como Skills especializam o agente e como MCP conecta ferramentas externas.

Entender Skills Entender MCP

Compare03

Separe padrão aberto de produto

Entenda por que um plugin nativo do Claude Code não é o mesmo pacote definido pelo Agent Plugins.

Ver a comparação

Segurança04

Revise antes de instalar

Portabilidade não substitui inspeção, autorização, controle de credenciais ou isolamento de processos.

Abrir o checklist

Agent Plugins × Claude

Agent Plugins não é “plugin do Claude”

Os nomes são parecidos porque os formatos compartilham componentes, como Skills e MCP. O contrato do pacote, porém, é diferente.

Agent Plugins 1.0.0

Usa plugin.json na raiz. Seu núcleo portável cobre Skills e MCP. Distribuição e recursos proprietários ficam com cada cliente.

Claude Code

Usa o manifesto opcional .claude-plugin/plugin.json e pode empacotar hooks, subagentes, LSP, temas e outros componentes nativos.

Em 6 de agosto de 2026, Anthropic e Claude não constavam na lista oficial de clientes compatíveis nem no comitê técnico inicial. Isso não prova oposição; apenas impede prometer instalação direta sem suporte ou adaptação.

Comparar estruturas e capacidades

Continue estudando