Skills e plugins no Claude Code: o que são, como instalar e quando criar os seus

Resposta curta: uma skill é um arquivo de instruções que o Claude Code carrega só quando a tarefa pede, e um plugin é um pacote que instala de uma vez várias skills, subagentes e conexões. Para instalar um plugin, basta digitar /plugin numa sessão do Claude Code e escolher no catálogo.

Quem começou a usar o Claude Code para tarefas de marca e marketing costuma passar por uma mesma fase: copiar e colar as mesmas instruções em toda conversa. O checklist do post, o jeito de montar um briefing, as regras de revisão. Skills e plugins existem para tirar esse trabalho da sua mão, e entender a diferença entre os dois economiza tempo e tokens.

Este é o segundo texto da nossa série sobre agentes de IA aplicados a marca. No primeiro, explicamos o que são subagentes e equipes de agentes. Aqui o assunto são as skills, que guardam procedimentos, e os plugins, que empacotam skills, agentes e outras peças para instalar de uma vez. As informações técnicas vêm da documentação oficial do Claude Code, consultada em outubro de 2026.

Se agentes de IA ainda são um assunto novo para você, o nosso guia de IA agêntica explica o conceito, e o texto sobre como usar IA em marca mostra as fases de quem está começando.

O que é uma skill

Uma skill é uma pasta com um arquivo chamado SKILL.md, que contém instruções para uma tarefa específica. O Claude usa a skill sozinho quando o pedido combina com ela, ou você a chama pelo nome, digitando /nome-da-skill. Na prática, é um procedimento escrito uma vez e reaproveitado sempre que a tarefa aparece.

A skill tem uma vantagem sobre colar instruções na conversa: ela custa pouco enquanto não é usada. O Claude Code mantém no contexto só a descrição de cada skill, para saber que ela existe. O corpo, com as instruções completas, entra apenas quando a skill é usada. Por isso dá para guardar um manual longo sem pesar em toda conversa.

Os comandos personalizados antigos, que ficavam em .claude/commands/, foram incorporados às skills. Um arquivo .claude/commands/briefing.md e uma skill .claude/skills/briefing/SKILL.md criam o mesmo /briefing. A skill acrescenta a pasta de apoio e a possibilidade de o Claude chamá-la sem você pedir.

Como é uma skill por dentro

O arquivo começa com um cabeçalho curto e segue com as instruções em texto comum. Um exemplo pensado para quem publica no blog:

---
name: checklist-post
description: Confere um post de blog antes da publicação. Use quando um rascunho estiver pronto para revisão final.
---

Confira o rascunho nesta ordem e liste o que falta, sem reescrever o texto:
1. Title com até 60 caracteres e a palavra-chave no começo.
2. Description com até 132 caracteres.
3. Pelo menos três links internos com âncora descritiva.
4. Parágrafos com até 60 palavras.
5. Texto alternativo na imagem de capa.

Como acontece com os subagentes, o campo que mais pesa é a description. É ela que diz ao Claude quando a skill serve. A documentação recomenda manter o SKILL.md com menos de 500 linhas e avisa que a descrição é cortada na listagem a partir de 1.536 caracteres.

A pasta pode guardar mais do que o SKILL.md. Exemplos, material de referência e scripts ficam em arquivos ao lado, e o SKILL.md indica quando cada um deve ser aberto. Um script é executado, sem que o texto dele entre no contexto. As skills pessoais ficam em ~/.claude/skills/ e as de um projeto, em .claude/skills/.

Skill, subagente ou CLAUDE.md: qual usar

Os três guardam instruções, mas cada um entra na conversa de um jeito, e essa diferença decide qual usar.

Regra prática: se a instrução vale para tudo o que se faz no projeto, ela vai no CLAUDE.md. Se vale para uma tarefa que aparece de vez em quando, vira skill. Se a tarefa gera muito material intermediário, ela vai para um subagente, que pode inclusive carregar skills próprias.

O que é um plugin

Um plugin é uma pasta que reúne skills, subagentes, hooks e servidores MCP para serem instalados e carregados juntos. Hooks são comandos que rodam em momentos fixos, como depois de cada edição. Servidores MCP conectam o Claude a ferramentas externas. O plugin se identifica por um arquivo de manifesto, .claude-plugin/plugin.json, com nome, versão e descrição.

Tudo isso funciona sem plugin. Uma skill salva em ~/.claude/skills/ já vale para todos os seus projetos. O plugin passa a fazer sentido quando você quer distribuir um conjunto: instalar com um comando, receber atualizações e garantir que a equipe use a mesma versão. As skills de um plugin aparecem com o nome dele na frente, como /meu-plugin:revisao.

Como instalar um plugin

Os plugins vêm de um marketplace, que é um catálogo: um repositório com um arquivo listando os plugins e onde buscar cada um. O Claude Code adiciona o marketplace oficial da Anthropic, chamado claude-plugins-official, na primeira vez que você abre uma sessão no terminal. Para ver o que ele oferece, digite /plugin e abra a aba Discover.

Para instalar pelo nome, o formato é plugin@marketplace:

/plugin install commit-commands@claude-plugins-official

Para usar o catálogo de outra empresa ou da sua equipe, adicione o marketplace uma vez e depois instale os plugins dele:

/plugin marketplace add dono/repositorio
/plugin install nome-do-plugin@nome-do-marketplace

Na instalação você escolhe o escopo. O de usuário ativa o plugin para você em todos os projetos do computador. O de projeto ativa para todo mundo que trabalha naquele repositório, pelo arquivo de configuração compartilhado. O local ativa só para você e só naquele projeto.

O que conferir antes de instalar

Um plugin roda com as suas permissões. Se ele traz scripts ou servidores, eles executam na sua máquina como se fossem você. A documentação recomenda revisar o plugin antes de instalar, e isso vale também para os marketplaces de terceiros, que são todos os que não pertencem à Anthropic, incluindo o de um colega.

Plugins ativos também ocupam espaço. O nome e a descrição de cada skill e agente ficam no contexto em toda mensagem, mesmo nas conversas em que nada do plugin é usado. Por isso compensa desativar o que não está em uso. O /plugin mostra, na aba de instalados, os plugins sem uso recente, e o marketplace oficial exibe uma estimativa de custo de contexto antes da instalação.

Como organizamos os nossos plugins

Na Headcore, a operação de marca roda no Growth System™, seis plugins que distribuímos por um marketplace privado. O brandbrain constrói o Brand Brain de cada marca, com posicionamento, voz e regras. O craft produz peças, o surf cuida de páginas e o brand-studio, de vídeo. O growthmkt mede o que foi ao ar, e a mesa-criativa julga cada peça antes de publicar. Juntos, somam 17 subagentes.

A decisão que mais pesou foi transformar regra em estrutura. No craft, um conceito que não foi aprovado não gera peça, porque o código não deixa.

No growthmkt, a saída não tem campo para dinheiro, e um teste confere isso a cada versão: o plugin mede, mas a decisão de verba continua com uma pessoa. Fizemos assim porque o modelo pode deixar passar uma instrução escrita no prompt, e uma trava no código ele não consegue contornar.

Também aprendemos uma coisa sobre atualização. O plugin instalado fica numa cópia separada do repositório, e editar o arquivo no repositório não muda o que a sessão carrega. A mudança só chega depois de enviada ao GitHub e atualizada pelo /plugin. Quando um ajuste parece não ter efeito, a primeira coisa a conferir é se a sessão está rodando a versão nova.

Por onde começar

Comece pelas skills. Escolha um procedimento que você explica para a IA toda semana, como o checklist de um post ou o roteiro de um briefing, e transforme em SKILL.md. Teste chamando com /nome e depois veja se o Claude a usa sozinho quando o pedido combina com a descrição.

Quando você tiver algumas skills e um ou dois subagentes que a equipe inteira deveria usar, empacote tudo num plugin e crie um marketplace num repositório da empresa. Antes de instalar plugins de outras pessoas, leia o que eles executam e desligue o que deixar de usar.

A série completa

Este texto faz parte de uma série de cinco sobre agentes de IA aplicados a marca:

1. Subagentes e equipes de agentes no Claude Code
2. Skills e plugins no Claude Code (este texto)
3. CLAUDE.md e Brand Brain: memória de marca para IA
4. Como revisar conteúdo gerado por IA
5. Como usamos IA na operação da Headcore

Perguntas frequentes

Fontes: documentação do Claude Code sobre skills e plugins, consultadas em 21/10/2026.