Trinity precisa pilotar um helicóptero. Tank não estuda manual: pega o cartucho da prateleira e carrega o programa inteiro.
O que é um Plugin?
Quatro características que transformam várias peças soltas em um cartucho instalável.
Empacota tudo
Skills, commands, hooks, subagents e MCP servers em um pacote único, com um manifesto.
Versionado
Cada plugin tem name e version. Você atualiza, congela ou volta atrás com controle.
Instalação em 1 comando
Um claude plugin install e o kit aparece pronto pra usar. Sem copiar pasta por pasta.
Compartilhável
Distribuído via marketplaces. Você publica uma vez, o time inteiro instala com um link.
Plugin · Skill solo · Hook solo
Plugin é o kit completo. Skill solo e hook solo são peças avulsas. Saber a diferença é saber quando entregar uma capacidade pronta.
Anatomia de um plugin
Uma pasta. Um manifesto na raiz. Subpastas para cada tipo de peça. Tudo no mesmo cartucho.
# Raiz do plugin: o cartucho inteiro meu-plugin/ ├── plugin.json # manifesto: name, version, deps ├── skills/ │ ├── revisor/SKILL.md # vira meu-plugin:revisor │ └── refator/SKILL.md # vira meu-plugin:refator ├── commands/ │ ├── briefing.md # vira /meu-plugin:briefing │ └── deploy.md # vira /meu-plugin:deploy ├── hooks/ │ └── pre-commit.sh # roda antes de commitar ├── agents/ │ └── code-reviewer.md # subagent especializado └── mcp/ └── server.json # MCP server declarado
plugin.json é o RG
Declara nome, versão, autor e o que tem dentro. Sem ele, não é plugin.
Subpastas são opcionais
Use só as que precisar. Um plugin pode ter só commands, ou só skills, ou todos juntos.
Anatomia da instalação
Como um cartucho é carregado
Você roda claude plugin install. O sistema baixa o cartucho, descompacta as peças e ativa skills, commands, hooks, agents e MCP de uma vez só.
O manifesto de um plugin
Um único plugin.json declara identidade, versão e tudo que o cartucho carrega.
{
"name": "meu-plugin",
"version": "1.2.0",
"description": "Kit de commands, skills e hooks para times pequenos",
"author": "sandeco",
"skills": [
"skills/revisor",
"skills/refator"
],
"commands": [
"commands/briefing.md",
"commands/deploy.md"
],
"hooks": {
"PreToolUse": "hooks/pre-commit.sh"
},
"agents": [
"agents/code-reviewer.md"
],
"mcp_servers": [
"mcp/server.json"
],
"dependencies": {
"codex": "^1.0.0"
}
}
name + version
Identidade do cartucho
skills + commands
Caminhos das peças
hooks + agents
Gatilhos e subagents
dependencies
Outros plugins exigidos
A prateleira: marketplaces
Marketplace é o catálogo de cartuchos. A Anthropic mantém o oficial; comunidade publica os próprios. Você adiciona o marketplace e ganha acesso a tudo dentro.
# Marketplace oficial da Anthropic claude plugin marketplace add \ anthropics/claude-plugins # Marketplace da comunidade (via repo) claude plugin marketplace add \ https://github.com/time/plugins # Lista os marketplaces conectados claude plugin marketplace list
# Procura cartuchos no marketplace claude plugin search github # Mostra detalhes de um plugin claude plugin info codex # Instala em um comando claude plugin install codex # O kit inteiro fica disponivel
Sacada: qualquer repositório GitHub com a estrutura certa vira marketplace. Você publica seu kit, o time todo instala apontando para o repo. Sem servidor, sem registro.
Os cinco comandos que você vai usar
Toda a gestão da prateleira cabe em cinco verbos. Adicionar, instalar, listar, atualizar, remover.
claude plugin marketplace add <url-ou-repo>
Conecta um catálogo de plugins ao seu Claude Code.
claude plugin install <plugin-name>
Baixa o cartucho e ativa skills, commands, hooks, agents e MCP.
claude plugin list
Mostra tudo que está instalado, com versão e marketplace de origem.
claude plugin update <name>
Atualiza para a versão mais nova publicada no marketplace.
claude plugin remove <name>
Desinstala o plugin e desliga tudo que ele trazia junto.
Cinco verbos. Toda a gestão de plugins do Claude Code cabe neles. Memorize uma vez, use para sempre.
Skills e commands ficam namespeados
O nome do plugin vira prefixo. Nada colide. Você sabe de onde cada peça vem só de olhar.
# plugin codex traz: codex/ ├── skills/rescue/ ├── skills/setup/ └── commands/rescue.md # plugin github traz: github/ ├── skills/pr-review/ └── commands/pr.md
/codex:rescue # skill do codex /codex:setup # skill do codex /github:pr # command do github # Skill é invocada pelo Claude # automaticamente conforme contexto: "use codex:rescue para investigar"
Sacada: dois plugins podem ter uma skill chamada rescue sem conflito. O prefixo do plugin desambigua tudo.
Instale um plugin em três passos
Adiciona o marketplace, instala o cartucho, usa o que veio dentro. Sem reiniciar nada.
# 1. Adiciona o marketplace oficial claude plugin marketplace add \ anthropics/claude-plugins # 2. Instala o plugin claude plugin install codex # 3. Usa o que veio dentro /codex:rescue
O Claude Code carrega o cartucho na hora. Skills, commands, hooks e MCP ficam ativos imediatamente.
Tank carrega o programa, Trinity pilota. Você instalou um kit inteiro com um comando.
Adicione o marketplace
claude plugin marketplace add apontando para o catálogo.
Instale o cartucho
claude plugin install <nome>. O kit todo entra.
Use o que veio
Digite /<plugin>:<peça> e o agente carrega o cartucho.
Cinco plugins que valem o dia
Cartuchos que entram na sua máquina e somam superpoderes. Você instala uma vez, usa todo dia.
Plugin 1 · codex
Companheiro Codex / GPT
Você está debugando e quer uma segunda opinião com outro modelo. O plugin codex integra o Codex CLI ao Claude Code: vira uma skill que você invoca quando precisa.
# codex/plugin.json { "name": "codex", "version": "1.0.0", "skills": [ "skills/rescue", "skills/setup" ], "commands": [ "commands/rescue.md" ], "agents": [ "agents/codex-rescuer.md" ] }
Ganho prático: dois modelos lado a lado sem trocar de janela. Claude pilota, Codex traz segunda opinião quando o problema é complicado.
Plugin 2 · github
Workflows de pull request
Abrir PR, revisar PR, comentar em PR. O plugin github traz commands prontos e uma skill que entende código antes de comentar.
/github:pr # abre PR a partir do branch /github:review # revisa PR atual ou por # /github:comment # comenta linha por linha /github:checks # mostra status dos CIs # skill auto-invocada quando o # Claude detecta intenção de PR github:pr-review
Ganho prático: o ciclo de PR vira conversa. Você não sai do terminal pra ler diff, comentar e validar checks.
Plugin 3 · testing
Test runners e skills de qualidade
Cartucho que entende seu stack de testes. Detecta Jest, Vitest, Pytest, Go test. Traz skill para gerar testes, command para rodar focado, hook para barrar commit sem cobertura.
# skills testing:generate # gera teste pra função testing:fix-flaky # estabiliza teste flaky # commands /testing:focus # roda só o que mudou /testing:coverage # mostra cobertura # hook PreCommit: block if coverage < 80%
Quer que eu gere o teste que falta? (s/n)
Ganho prático: qualidade vira default, não esforço. O hook segura o commit ruim, a skill produz o teste que falta.
Plugin 4 · docs
Geradores de documentação
Documentação que nasce do código. Skill que lê módulos e produz README, command que monta CHANGELOG do diff, agent que mantém ADRs em dia.
# skills docs:readme # gera README do módulo docs:api # gera doc de API # commands /docs:changelog # CHANGELOG do release /docs:diagram # diagrama Mermaid # agent docs:adr-keeper # mantém ADRs em sync
Ganho prático: documentação para de envelhecer. O cartucho regenera do código a cada release, sem trabalho manual.
Plugin 5 · deploy
Workflows de deploy seguro
Deploy não é só rodar comando. É checar testes, validar tag, confirmar com humano, observar logs. O cartucho deploy traz tudo isso embrulhado com hook que barra deploy fora de horário.
# commands /deploy:staging # deploy seguro pra staging /deploy:prod # prod com double-check /deploy:rollback # volta pra release anterior # skill deploy:smoke-test # roda smoke pós-deploy # hook PreToolUse: bloqueia deploy fora do horario
Ganho prático: deploy seguro vira default do time. O cartucho carrega regra, checagem e rollback, ninguém esquece o passo.
Crie um plugin em três passos
Você já tem skills e commands no seu projeto. Só falta empacotar.
Crie a pasta raiz
meu-plugin/ ├── skills/ ├── commands/ ├── hooks/ └── plugin.json
Uma pasta com subdivisões. As que não usar, deixe vazias ou omita.
Escreva o manifesto
{
"name": "meu-plugin",
"version": "0.1.0",
"commands": [
"commands/x.md"
]
}
plugin.json declara o que tem dentro. Só campos usados precisam aparecer.
Publique no Git
git push origin main # Time instala apontando # pro seu repo claude plugin install user/repo
Qualquer repo público (ou privado autorizado) vira marketplace de um plugin só.
Você é o autor agora: empacote as práticas do seu time, publique uma vez, distribua para todo mundo com um único install.
Os cinco cartuchos lado a lado
Resumo dos plugins que você acabou de ver.
| Plugin | O que entrega | Ganho | |
|---|---|---|---|
| codex | Skill e command para chamar Codex/GPT como segunda opinião | Dois modelos juntos | |
| github | Commands para abrir, revisar e comentar PR sem sair do CLI | Ciclo de PR fluido | |
| testing | Skills para gerar teste e command para rodar focado, com hook de cobertura | Qualidade por default | |
| docs | Geradores de README, CHANGELOG e ADR a partir do código | Doc sempre viva | |
| deploy | Workflows de deploy com checagem, confirmação e rollback | Deploy sem susto |
Cinco plugins. Um claude plugin install cada. O kit completo aparece sem você copiar pasta por pasta.
Quer dominar cada peça?
O livro Engenharia de Software para Agentes Inteligentes destrincha commands, hooks, skills, MCP, subagents e plugins, tudo que faz o agente trabalhar a seu favor.
·
@canalsandeco
Plugin é o cartucho que junta tudo o que o livro ensina e entrega num único comando.
Tank tem prateleira. Você tem npm install. A Nabucodonosor vira sua, peça por peça.