SK
Uma skill
Um método, um arquivo
PL
Um plugin
Skills, agentes, hooks, MCP

Claude Skills vs. Plugins: de qual deles você realmente precisa?

As duas palavras são usadas como se significassem a mesma coisa, mas não significam. Uma skill é um arquivo que ensina um método ao Claude. Um plugin é um pacote que pode conter skills e várias outras coisas, e é instalado de uma maneira diferente, de um lugar diferente e por um tipo diferente de pessoa.

É entender isso errado que leva as pessoas a procurar um marketplace de plugins quando, na verdade, queriam um único arquivo que pudessem colar no Claude, ou a instalar um plugin inteiro quando uma skill teria resolvido.

A resposta curta

Skill Plugin
O que é Um arquivo SKILL.md com instruções Um pacote que pode reunir skills, agentes, comandos, hooks e servidores MCP e LSP
Um arquivo que você baixa, cola ou ativa na sua conta De onde vem Um marketplace que você adiciona e do qual instala
Onde funciona Claude na web, no desktop, no Cowork, no Claude Code e qualquer ferramenta que leia o formato Claude Code
Qualquer pessoa que esteja realizando o trabalho Para quem é Principalmente desenvolvedores e equipes que entregam um fluxo de trabalho completo de uma só vez
Tempo até o primeiro uso Cerca de um minuto Dois comandos, além de encontrar um marketplace em que você confia
  • Um plugin pode conter skills. Uma skill não pode conter um plugin.
  • Se você não está no Claude Code, a questão do plugin não se aplica a você.
  • Uma tarefa repetitiva é uma skill. Um fluxo de trabalho completo que você quer delegar a uma equipe é um plugin.

O que um plugin realmente inclui

Um plugin é um contêiner. Essa é a ideia toda, e é por isso que a palavra parece vaga: o conteúdo varia completamente de um plugin para outro. De acordo com a própria documentação da Anthropic, um plugin pode incluir qualquer um dos itens a seguir:

Skills
Os mesmos arquivos SKILL.md que você pode usar por conta própria. Um plugin pode incluir um ou vinte.
Agents
Subagentes que recebem uma tarefa e a executam em várias etapas sem pedir confirmação.
Comandos
Comandos de barra, para que um fluxo de trabalho tenha um nome que você possa digitar.
Hooks
Manipuladores de eventos acionados automaticamente, por exemplo, após a execução de uma ferramenta.
Servidores MCP e LSP
Conexões com ferramentas externas, fontes de dados e servidores de linguagem.

Leia essa lista novamente e a distinção ficará óbvia. Uma skill é uma das coisas que um plugin pode conter. Perguntar se você deve usar uma skill ou um plugin é um pouco como perguntar se deve usar um documento ou uma pasta.

O que é um marketplace de plugins do Claude Code

Um marketplace aqui não é uma loja. Nada é comprado e não há checkout. É um arquivo de catálogo que informa ao Claude Code onde está um conjunto de plugins e, na prática, é um repositório git contendo um único manifesto em um caminho fixo:

Arquivo obrigatório
.claude-plugin/marketplace.json, na raiz do repositório

Você aponta o Claude Code para um marketplace e instala a partir dele. Dois comandos, nesta ordem:

  1. Adicionar o marketplace: /plugin marketplace add owner/repoou /plugin marketplace add ./my-marketplace para um no seu próprio disco.
  2. Instale a partir dele: /plugin install plugin-name@marketplace-name.

Um marketplace pode ser hospedado no GitHub, em qualquer outro host Git, incluindo GitLab, Bitbucket e servidores auto-hospedados, em uma URL HTTPS simples que aponte para o manifesto ou em um caminho local. A Anthropic também publica um diretório oficial e selecionado dos seus próprios marketplaces.

Como qualquer pessoa pode publicar um, um marketplace é um canal de distribuição, não um indicador de qualidade. Adicionar um significa confiar em quem mantém aquele repositório, e os plugins podem incluir hooks e servidores MCP que realizam ações concretas na sua máquina. Adicione marketplaces que você consiga identificar, da mesma forma que faria com qualquer outra dependência.

Quando cada um é a escolha certa

A regra sincera diz respeito ao escopo, não à sofisticação.

Use uma skill

Você repete um tipo de tarefa e quer que ela seja realizada de forma consistente: um relatório no seu formato, uma revisão de contrato baseada na sua lista de verificação, textos no tom da sua marca. Você trabalha no Claude na web, no aplicativo para desktop ou no Cowork. Quer que funcione em cerca de um minuto e quer que o mesmo arquivo continue funcionando se você trocar de ferramenta mais tarde.

Use um plugin

Você está no Claude Code, e o que deseja não é um método, mas uma configuração completa: várias skills, alguns subagentes, alguns comandos de barra, talvez um hook executado após cada edição e um servidor MCP apontando para o seu rastreador de problemas. Você quer entregar toda essa configuração aos colegas de equipe como uma única unidade instalável e mantê-la atualizada a partir de um só lugar.

A maioria das pessoas que faz essa pergunta está no primeiro grupo e ainda não sabe disso, porque plugin é a palavra que aparece nas conversas entre desenvolvedores, enquanto skill é a palavra que descreve o que elas realmente querem.

É possível usar os dois?

Sim, e isso é comum. As skills que você habilita na sua conta do Claude acompanham você no aplicativo web, no aplicativo para desktop e no Cowork. Os plugins ficam no Claude Code e podem trazer suas próprias skills. Instalar um plugin não remove nem substitui as skills que você já usa, e usar skills não impede que você adicione um plugin mais tarde.

Se você não souber por onde começar, comece com uma skill. É um compromisso menor, funciona em mais lugares e, se depois você decidir que quer todo o fluxo de trabalho empacotado para uma equipe, o arquivo da skill que você já tem será uma das peças incluídas no plugin.

Skills e plugins: perguntas frequentes

Qual é a diferença entre uma skill do Claude e um plugin do Claude Code?

Uma skill é um único arquivo SKILL.md que ensina o Claude a realizar um tipo de tarefa. Um plugin é um pacote para o Claude Code que pode reunir skills, agentes, comandos de barra, hooks, servidores MCP e servidores LSP em uma unidade instalável. Um plugin pode conter skills; uma skill não pode conter um plugin.

O que é um marketplace de plugins do Claude Code?

Um catálogo que informa ao Claude Code onde está um conjunto de plugins. Na prática, é um repositório git com um arquivo de manifesto em .claude-plugin/marketplace.json na raiz. Nada é comprado ali; é um canal de distribuição, não uma loja.

Como adiciono um marketplace de plugins no Claude Code?

Execute /plugin marketplace add owner/repo para um marketplace hospedado no GitHub ou /plugin marketplace add ./my-marketplace para um marketplace no seu próprio disco. Depois, instale um plugin usando /plugin install plugin-name@marketplace-name.

Onde um marketplace de plugins pode ser hospedado?

No GitHub, em qualquer outro host git, incluindo GitLab, Bitbucket e servidores próprios, em uma URL HTTPS simples que aponte para o arquivo de manifesto ou em um caminho do sistema de arquivos local. A Anthropic também publica um diretório oficial com curadoria das próprias opções.

Os plugins funcionam fora do Claude Code?

Não. Plugins são um recurso do Claude Code. Skills não são: o mesmo arquivo de Skill funciona no Claude na web, no aplicativo para desktop, no Cowork, no Claude Code e em qualquer outra ferramenta que leia o formato Agent Skills.

Um plugin é mais seguro do que uma Skill?

Na verdade, o oposto. Uma Skill sozinha é apenas texto simples, então o pior que pode fazer é fornecer instruções ruins. Um plugin pode incluir hooks e servidores MCP, que são códigos executados e conexões que alcançam recursos externos. Isso não é motivo para evitar plugins, mas é um motivo para saber quem publicou um antes de adicionar o marketplace dessa pessoa.

Devo comprar um plugin ou uma Skill?

Se você repete um tipo de tarefa e quer que ela seja executada de forma consistente, compre a Skill. Se você está no Claude Code e quer um fluxo de trabalho completo empacotado para uma equipe, com comandos, hooks e conexões com ferramentas, é para isso que serve um plugin. A maioria das pessoas que fazem essa pergunta quer uma Skill e só ouviu a palavra plugin.

É possível usar um plugin e uma Skill ao mesmo tempo?

Sim. As Skills ativadas na sua conta Claude funcionam no aplicativo web, no aplicativo para desktop e no Cowork. Os plugins ficam no Claude Code e podem trazer suas próprias Skills. Um não remove nem desativa o outro.

Comece com uma Skill

Publicamos arquivos de Skills, não plugins, porque um arquivo representa um compromisso menor e funciona em mais lugares. Se você quiser entender primeiro como tudo funciona, o guia sobre o que é uma Skill e como ativá-la explica tudo.

Caso contrário: navegue pelo catálogo por função ou escolha uma das Skills gratuitas e teste o fluxo de trabalho antes de pagar por qualquer coisa.

KissMySkills é um marketplace independente e não é afiliado, endossado nem conectado à Anthropic, à OpenAI ou a qualquer outra empresa de AI. Claude e Claude Code são produtos da Anthropic.