Como criar um plugin para o Claude Cowork e desenvolver seu próprio funcionário de IA (Curso Completo)

A maioria das pessoas trata o Claude Cowork como um organizador inteligente de arquivos.

Salve isto :)

Peça para ele organizar alguns arquivos. Converter uma planilha. Talvez renomear uma pasta.

Essa é a versão júnior do Cowork.

A versão sênior é construir um plugin — um funcionário de IA completo que conhece seu setor, segue seu processo exato, produz seu formato de saída exato e executa seus fluxos de trabalho de forma autônoma enquanto você faz outra coisa.

Um funcionário de IA que aparece todos os dias, nunca falta, nunca precisa ser treinado duas vezes e fica melhor a cada semana.

Um plugin do Cowork é um pacote estruturado que contém tudo o que o Claude precisa para desempenhar uma função específica: as habilidades, os comandos, os materiais de referência, as regras e as verificações de qualidade. Instale uma vez e você tem um funcionário.

Este é o curso completo sobre como construir um.

O que é um Plugin, Na Verdade

Um plugin é uma pasta. Só isso. Uma pasta com uma estrutura específica que diz ao Cowork exatamente o que fazer e como fazer.

Dentro dessa pasta:

markdown

1meu-plugin/
2├── .claude-plugin/
3│   └── plugin.json        ← Identidade: nome, função, descrição
4├── skills/
5│   └── tarefa-principal/
6│       └── SKILL.md        ← O fluxo de trabalho: processo passo a passo
7├── commands/
8│   └── executar-tarefa.md  ← Comandos de barra: /prefixo:comando
9├── references/
10│   └── modelos.md          ← Materiais de referência: modelos, benchmarks, exemplos
11├── global-instructions.md  ← Ordens permanentes: personalidade, preferências, padrões
12└── folder-instructions.md  ← Contexto específico do projeto

plugin.json informa ao Cowork que esta pasta é um plugin, qual função ele desempenha e quando ativar.

SKILL.md é o cérebro — o processo passo a passo que seu funcionário de IA segue para cada tarefa. Este é o arquivo mais importante. Acertar isso faz todo o resto funcionar.

Commands são gatilhos de comando de barra. Digite /prefixo:comando e o fluxo de trabalho inteiro é acionado.

References são os modelos, benchmarks, dados do setor e exemplos que seu funcionário precisa para fazer o trabalho corretamente.

Global instructions são as ordens permanentes — personalidade, estilo de comunicação, padrões de qualidade e suposições padrão.

Folder instructions são o contexto específico do projeto — o que está nesta pasta, quais são as prioridades atuais e como lidar com os dados específicos aqui.

Fase 1: Pesquise a Função (30 Minutos)

Antes de escrever qualquer arquivo, você precisa saber exatamente o que seu funcionário de IA faz.

Abra o Claude e use este prompt:

"Pesquise o fluxo de trabalho profissional completo para um [FUNÇÃO] em [SETOR]. Inclua: o processo passo a passo que eles seguem, ferramentas e fontes de dados que usam, métricas-chave e critérios de decisão, formatos de saída comuns e casos extremos e armadilhas de nível especialista. Seja abrangente — estou construindo um fluxo de trabalho automatizado a partir disso."

Leia a saída com atenção. Este é o material bruto a partir do qual seu arquivo de habilidade será construído.

Agora entreviste a si mesmo. Como é a SUA versão desse processo? Quais atalhos você usa? Quais verificações de qualidade você sempre executa? Quais erros você sempre observa? O que é "bom" versus "ruim"?

Os melhores funcionários de IA não são construídos a partir de melhores práticas genéricas. Eles são construídos a partir da SUA experiência específica.

Fase 2: Escreva o Arquivo de Habilidade (60 Minutos)

O SKILL.md é o cérebro do seu funcionário de IA. Tudo o que ele sabe sobre como fazer seu trabalho está aqui.

Aqui está a estrutura:

name: [nome-da-habilidade]

description: [Quando isso deve ativar? Seja agressivo com frases de gatilho.

"Use esta habilidade quando o usuário disser: [liste de 5 a 7 frases].

NÃO use para: [liste coisas que parecem semelhantes, mas são diferentes]."]

Visão Geral

[Um parágrafo: o que esta habilidade faz e o que ela produz]

Processo

[Passos numerados. Cada passo é específico, testável e inequívoco.

Não "analise os dados", mas "compare o período atual com o período anterior

e calcule a variação percentual para cada métrica."]

[Passo com instrução específica]
[Passo com instrução específica]
[Passo com instrução específica] ...

Formato de Saída

[Exatamente como a entrega deve ser]

Formato do título
Cabeçalhos das seções em ordem
Restrições de tamanho
Requisitos de formatação

Regras

[Seus padrões de qualidade inegociáveis]

[Regra 1]
[Regra 2]
[Regra 3]

Casos Extremos

[O que fazer quando as coisas não são diretas]

Se [situação]: [ação específica]
Se [situação]: [ação específica]

Lista de Verificação de Qualidade

[Execute isso antes de entregar qualquer saída]

[ ] [Verificação 1]
[ ] [Verificação 2]
[ ] [Verificação 3]

O campo de descrição no frontmatter YAML é a parte mais crítica. Se for muito vago, a habilidade nunca ativa. Se for muito amplo, ela sequestra conversas não relacionadas. Liste de 5 a 7 frases de gatilho específicas E limites negativos explícitos.

Fase 3: Construa os Arquivos de Suporte (30 Minutos)

O plugin.json:

{

"name": "meu-funcionario-ia",

"description": "Um [FUNÇÃO] que [O QUE FAZ] para [QUEM]",

"version": "1.0"

}

O comando de barra:

Crie um arquivo markdown em /commands/ que acione seu fluxo de trabalho:

/funcionario:executar

Execute a habilidade [tarefa-principal] nos dados da pasta atual.

Passos:

Leia todos os arquivos relevantes no diretório de trabalho
Execute a habilidade seguindo cada passo do SKILL.md
Execute a lista de verificação de qualidade antes de entregar
Salve a saída como [formato] na pasta atual
Forneça um breve resumo do que foi produzido

Instruções globais:

Você é um [FUNÇÃO] com [ANOS] de experiência em [SETOR].

Ordens Permanentes:

Comece com a recomendação, explique depois
Sempre use números específicos, nunca descrições vagas
Se os dados estiverem faltando ou forem ambíguos, sinalize — nunca adivinhe
Formato de saída padrão: [SUA PREFERÊNCIA]
Estilo de comunicação: [DIRETO/CONVERSACIONAL/FORMAL]
Em caso de dúvida, pergunte em vez de presumir

Arquivos de referência:

Adicione quaisquer modelos, dados de benchmark, padrões do setor ou exemplos que seu funcionário precisar. Quanto mais específicos forem seus materiais de referência, mais especializada será a saída.

Fase 4: Instale, Teste e Refine

Instale a pasta do plugin no seu ambiente Claude Cowork. Use este prompt no Cowork:

"Tenho uma pasta de plugin em [CAMINHO]. Verifique se a estrutura é válida — confira plugin.json, frontmatter do SKILL.md e arquivos de comando. Instale e execute um teste rápido com o comando de barra mais simples."

Agora teste com trabalho real. Não dados de amostra. Dados reais do seu fluxo de trabalho real.

Execute 5 vezes com entradas diferentes. Após cada execução, avalie:

Seguiu cada passo do SKILL.md?
Seguiu as regras?
A saída correspondeu à especificação de formato?
Você usaria esta saída como está ou precisa de edição significativa?

Toda vez que algo não atingir o alvo, atualize o SKILL.md. Adicione uma regra. Aperte um passo. Adicione um exemplo mostrando como é bom versus ruim.

Este ciclo de refinamento é o que transforma um funcionário de IA medíocre em um excepcional. Na execução 10, a qualidade da saída será drasticamente maior do que na execução 1.

Fase 5: Escalone Seu Funcionário de IA

Assim que sua habilidade principal estiver funcionando de forma confiável, expanda as capacidades do funcionário.

Adicione uma segunda habilidade. Seu analista de pesquisa agora também pode fazer monitoramento competitivo. Seu estrategista de conteúdo agora também pode reaproveitar conteúdo. Cada nova habilidade é um novo SKILL.md na pasta de habilidades.

Adicione fluxos de trabalho automatizados. Encadeie várias habilidades em processos de várias etapas acionados por um único comando de barra. Pesquisa → análise → relatório → distribuição. Um comando, quatro habilidades, zero etapas manuais.

Adicione tarefas agendadas. Seu funcionário de IA executa o relatório semanal toda sexta-feira às 16h. Processa a caixa de entrada diária toda manhã às 7h. Examina concorrentes toda segunda-feira. Operação verdadeiramente autônoma.

Adicione subagentes. Para fluxos de trabalho complexos, seu funcionário de IA pode criar vários subagentes que trabalham em paralelo. Cinco arquivos processados simultaneamente em vez de sequencialmente. A melhoria de velocidade se acumula a cada subagente adicional.

O Sistema de Revisão de Desempenho

Aqui está o que separa as pessoas que constroem um funcionário de IA decente daquelas que constroem um excelente.

Toda semana, revise as saídas. Anote o que funcionou perfeitamente, o que precisou de correções e o que você teve que refazer manualmente. Em seguida, atualize o SKILL.md.

Isso leva 15 minutos por semana. O efeito composto ao longo de dois meses é imenso.

Na semana 1, seu funcionário é funcional. Na semana 4, é bom. Na semana 8, está produzindo trabalho que levaria meses de treinamento para um funcionário júnior humano igualar.

A ferramenta não melhora sozinha. Suas instruções melhoram. E suas instruções estão totalmente sob seu controle.

Por Onde Começar Agora Mesmo

Escolha a tarefa na qual você mais gasta tempo toda semana. Aquela que você detesta. Aquela que segue o mesmo processo toda vez.

Gaste 2 horas construindo o plugin seguindo este curso.

Até hoje à noite, você terá um funcionário de IA que cuida da sua tarefa mais demorada. No próximo mês, você vai se perguntar como fazia isso manualmente.

A maioria das pessoas continuará fazendo tudo sozinha porque construir um funcionário de IA "parece complicado".

Aqueles que gastarem 2 horas hoje terão um funcionário de IA autônomo trabalhando para eles todos os dias pelo resto do ano.

Siga-me @eng_khairallah1 para mais arquiteturas de automação, designs de fluxo de trabalho e playbooks de IA para negócios.

Espero que isso tenha sido útil para você, Khairallah ❤️