📦 Distribuir e projeto final

Para outra pessoa instalar, o mod precisa estar num marketplace: um catálogo que diz quais plugins existem e onde está cada um. É um arquivo só, .claude-plugin/marketplace.json, na raiz do repositório.

O kit da Prompt Advisers (MIT) é um bom modelo: um repositório, um marketplace, dez plugins em plugins/.

{
  "name": "claude-mods-kit",
  "owner": {
    "name": "Prompt Advisers"
  },
  "plugins": [
    {
      "name": "terminal-pet",
      "source": "./plugins/terminal-pet",
      "description": "A pixel-art crab above the prompt that reacts live to what Claude is doing. /pet for commands."
    },
    {
      "name": "coral-skin",
      "source": "./plugins/coral-skin",
      "description": "Coral, ink and cream reskin of Claude Code with risk-coded tool rows. Toggle with /skin."
    },

Com o marketplace.json na raiz, o repositório inteiro vira o marketplace. Quem quer instalar faz duas coisas: adiciona o marketplace pelo dono/repo e instala o plugin pelo nome.

O --scope diz onde a instalação vale: user (todos os seus projetos), project (o projeto, e quem clonar o repositório) ou local (só você, só neste projeto). O módulo 1.3 detalha cada um.

Como ler o desenho: só a caixa âmbar é trabalho seu. As duas azuis são os comandos de quem instala. A caixa cinza lembra que a instalação vale para a próxima sessão, não para a que já está aberta.

claude plugin marketplace add inematds/claude-mods-starter-kit --scope user
claude plugin install terminal-pet@claude-mods-kit --scope user

A referência oficial separa dois casos. Um marketplace que é uma pasta sua, com source relativo, é lido da própria pasta: edite, rode /reload-plugins e pronto, sem versão nova nem reinstalar.

Todo o resto (marketplace vindo de repositório, URL, git, npm) roda a cópia feita na instalação. Uma mudança sua só chega a quem usa como versão ou commit novo, por claude plugin update e depois /reload-plugins.

O guia guides/BUILD-YOUR-OWN.md do kit tem uma seção "Review before sharing" que resume o cuidado: um plugin público é código que outras pessoas vão rodar, com as permissões do Claude Code delas. As ações dele precisam ser fáceis de inspecionar.

Na prática, o Rafa revisa a pasta do mod duas vezes: uma procurando o que tirar, outra conferindo o que precisa estar.

Leia todos os arquivos de mods/ e .claude-plugin/marketplace.json. Liste qualquer caminho pessoal, chave, token, e-mail, transcrição de conversa ou arquivo de settings que encontrar, com o arquivo e a linha. Não altere nada.

O projeto final junta as quatro trilhas num mod seu. O exemplo é o do Rafa: ver o que o Claude toca no repositório e não perder trabalho entre sessões. Escolha a sua ideia, mas cumpra os sete itens.

Como ler o desenho: as sete caixas azuis são os requisitos; cada uma vem de um módulo do curso. A linha âmbar embaixo é a prova: sem ela, o projeto não está pronto.

claude plugin validate <pasta>
claude plugin test <pasta>
claude -p "/<comando>" --plugin-dir <pasta>

Você terminou o curso técnico. Daqui, três direções: mais fundo nos hooks clássicos e nos plugins de produção, mais perto da guarda com o agent runtime, ou de volta ao código dos dois kits, agora lendo como autor.

E lembre a regra do começo: a API está em acesso antecipado. A cada versão nova do Claude Code, rode o checar nos seus mods e leia o arquivo de tipos antes de culpar o código.