A maioria das equipes usa Claude Code como um assistente de digitação sofisticado. A gente usa como colega de equipe sênior que sabe exatamente o que fazer antes de ser pedido. A diferença está nos plugins, skills, hooks e MCPs que transformam o Claude Code num sistema operante no contexto real da sua operação. Este artigo é sobre como isso funciona na prática — incluindo o que liberamos em /downloads para quem quiser replicar.
Resumo rápido: Claude Code pode ser estendido com skills (comandos especializados), plugins (pacotes de skills+hooks+configurações), hooks (ações automáticas em eventos), e MCPs (servidores que conectam IA a sistemas externos). Juntos, eles reduzem tarefas repetitivas a um comando e permitem que agentes tomem ação sem supervisão manual constante.
O que são skills e por que elas existem
Uma skill é um prompt especializado com instrução, contexto e comportamento esperado — tudo codificado num arquivo YAML ou Markdown que o Claude Code carrega automaticamente. Quando você digita /maxvision:code-review, você não está escrevendo um prompt. Você está acionando uma rotina construída para revisar código com critérios específicos: segurança, reuso, complexidade, convenções do projeto.
A diferença para um prompt no chat é que a skill carrega contexto de projeto, acessa arquivos relevantes, executa ferramentas de análise e formata a saída de um jeito consistente. Todo mundo na equipe recebe o mesmo comportamento, independente de quem aciona.
Skills se organizam em grupos:
- Skills de desenvolvimento — revisão de código, planejamento de features, execução de planos, debugging
- Skills de operações — snapshot de contexto, limpeza de branches, dispatch de agentes em background
- Skills de conteúdo — redação, revisão editorial, extração de keywords
No dia a dia da MaxVision, skills de revisão de código e planejamento são acionadas antes de todo commit não trivial. A skill de context-save pausa o trabalho e grava estado quando precisa mudar de tarefa no meio do caminho. Skills de contenúdo rodam quando há produção de blog ou roteiro.
Plugins: um pacote completo, não só um comando
Se uma skill é um único comando especializado, um plugin é um sistema: agrupa skills, hooks, configurações e integrações MCPs num pacote instalável.
O plugin fallow, por exemplo, que usamos no pipeline deste próprio site, inclui o servidor MCP do Fallow (análise determinística de TypeScript), skills de audit e health check, e regras sobre quando aplicar correções automáticas. Instalar o plugin uma vez ativa tudo junto.
A anatomia de um plugin inclui:
plugin.json— manifest com nome, versão e declaração de dependênciasskills/— diretório com os prompts especializadoshooks/— scripts que disparam em eventos (pré-commit, pós-tarefa, início de sessão)settings/— permissões e configurações específicas do plugin
Um plugin bem construído altera o comportamento do Claude Code de forma silenciosa e útil: você não precisa lembrar de chamar nada porque o hook já chama no momento certo.
Hooks: a automação que dispara sem você pedir
Hooks são a parte que mais impacta produtividade sem exigir mudança de hábito. Eles definem o que acontece em eventos específicos: antes de uma ferramenta ser executada, depois de uma tarefa completar, ao iniciar uma sessão.
Exemplos reais de hooks que usamos:
Hook de pré-commit: antes de registrar qualquer commit, o hook roda typecheck e lint. Se falhar, o commit não acontece. Acabou o problema de push com erro óbvio que só aparecia no CI.
Hook de início de sessão: quando abrimos o Claude Code no diretório do site, um hook verifica se há algum [maxvision-context] salvo — estado de trabalho pausado. Se houver, oferece retomar de onde parou.
Hook de pós-tarefa: ao finalizar uma tarefa longa, um hook formata o resumo e envia notificação. Em projetos com automação n8n, isso pode disparar um webhook que registra a tarefa no CRM.
A distinção importante: hooks rodam no host, não no modelo. Eles executam código real (bash, node, python) com base em eventos do Claude Code. Isso significa que podem fazer qualquer coisa que o sistema operacional permite.
MCPs: a ponte entre IA e sistemas reais
MCP — Model Context Protocol — é o que torna possível o Claude Code falar com sistemas externos de verdade. Não é uma simulação: é uma conexão real ao banco de dados, ao ERP, ao CRM, ao bucket de storage, à API da plataforma.
Um servidor MCP expõe ferramentas para o modelo. Quando Claude Code tem o servidor MCP do Supabase configurado, ele pode criar tabelas, rodar queries SQL, listar funções edge — tudo sem sair do contexto da conversa. Quando tem o servidor MCP do n8n, pode criar e ativar workflows diretamente.
MCPs que usamos no dia a dia:
- Supabase MCP — banco de dados e autenticação (este site roda sobre Supabase)
- n8n MCP — criação e ativação de workflows de automação
- Fallow MCP — análise de código TypeScript/JavaScript sem chamar serviço externo
- ESLint MCP — lint integrado ao contexto de review
- VPS MCP — execução de comandos no servidor, listagem de containers, logs
Os MCPs e skills que utilizamos internamente — incluindo versões prontas para instalar — estão organizados por categoria em /downloads, com licença declarada em cada componente.
MCPs proprietários que desenvolvemos ficam disponíveis em /downloads para clientes e comunidade: integração com CRMs específicos, pipelines de geração de conteúdo, orquestração de agentes audiovisuais.
Como a MaxVision usa isso no cotidiano
Dogfood real: todos os artigos deste blog passam por um pipeline assistido por Claude Code com skills de redação, revisão de SEO e verificação de links internos. O processo não elimina o redator — elimina o trabalho mecânico que não precisa de julgamento humano.
No desenvolvimento do site:
- Uma skill de planejamento (
writing-plans) lê o objetivo e propõe um plano de implementação com arquivos a editar - Uma skill de revisão de engenharia (
plan-eng-review) avalia o plano antes de executar - A execução (
execute-plan) acontece com o agente operando em worktree isolada, com checkpoint automático - Uma skill de code review (
code-review) verifica o diff antes do merge - Um hook de pré-commit garante que typecheck e lint estão limpos
Em operações de marketing:
A skill de extração de keywords lê um briefing e retorna clusters temáticos. A skill de planejamento de conteúdo organiza o calendário. MCPs de analytics puxam dados de performance direto do GA4 para o contexto de análise.
Em operações de DevOps:
O MCP do VPS permite que o agente liste containers, veja logs e reinicie serviços sem sair do contexto. Hooks disparam alertas quando health checks falham. Skills de hardening auditam configurações de servidor contra um checklist.
Comparativo: Claude Code puro versus com plugins, skills e MCPs
| Dimensão | Claude Code puro | Com plugins, skills e MCPs |
|---|---|---|
| Acionamento de tarefas | Prompt manual a cada vez | Skills acionadas por comando ou hook automático |
| Consistência | Varia com o prompt do dia | Comportamento idêntico toda execução |
| Contexto de projeto | Precisa descrever no chat | Carregado automaticamente pela skill |
| Acesso a sistemas externos | Nenhum (só lê arquivos locais) | CRM, banco, ERP, API via MCP |
| Automação sem supervisão | Impossível | Hooks + agentes em background |
| Onboarding de novo membro | Treinar no contexto | Instalar o plugin e os padrões vêm junto |
| Auditoria de ações | Log de chat | Commits atômicos + checkpoint de estado |
| Cobertura de segurança | Depende do prompt | Skills de security audit + hooks de validação |
O que está disponível em /downloads
Parte do que usamos internamente foi empacotado e disponibilizado em /downloads. A divisão atual:
Free: skills individuais de planejamento, skill de context-save/restore, template de plugin básico com estrutura de pastas, exemplos de hooks para pré-commit e início de sessão.
Pro: plugin completo de desenvolvimento web (skills de revisão, planejamento, execução, debugging + hooks de CI local + configuração de MCP para projetos Supabase/Next.js), plugin de operações de conteúdo (skills de redação, revisão editorial, keyword extraction, FAQ schema), templates n8n prontos para integrar com Claude Code.
Agency: MCPs proprietários de integração com CRMs e ERPs específicos, plugin de orquestração multi-agente (dispatch paralelo, checkpoint, resume), configurações de ambiente para equipes (permissões por perfil, settings compartilhados).
Tudo com licença declarada no manifest — MIT para os componentes livres, licença proprietária para os MCPs de integração.
Por que isso importa além do dev
A tendência que estamos acompanhando: times de marketing, conteúdo e operações estão adotando Claude Code com skills e MCPs da mesma forma que times de dev. A abstração de skill é suficientemente simples para quem não escreve código diariamente.
Uma skill de geração de copy, configurada com as diretrizes da marca, o tom certo e os produtos corretos, entrega resultados consistentes mesmo quando quem usa não é redator de formação. Um MCP de analytics permite que o estrategista de mídia pague uma query no GA4 sem precisar de intermediário técnico.
A curva de entrada ainda é real — instalar, configurar, entender o que cada skill faz. Mas o delta de produtividade uma vez configurado é grande o suficiente para justificar o investimento de setup.
Perguntas Frequentes
Preciso saber programar para usar skills e plugins?
Para usar o que já existe, não. Skills são acionadas por comando de texto e plugins se instalam seguindo a documentação. Para criar skills novas ou customizar hooks, um nível básico de familiaridade com YAML e linha de comando ajuda. MCPs proprietários já vêm prontos para instalar.
Skills funcionam em qualquer projeto ou são específicas para TypeScript?
Skills funcionam independente de linguagem — são prompts especializados com acesso ao sistema de arquivos. MCPs específicos podem ser limitados por linguagem (como o Fallow MCP, que analisa TS/JS), mas a estrutura de skills e hooks é agnóstica.
Qual a diferença entre skill e comando slash?
Um comando slash (ex: /code-review) é o nome que aciona a skill. A skill é o arquivo que define o comportamento. Um plugin pode registrar múltiplos comandos slash, cada um mapeado para uma skill diferente.
Os MCPs de integração de CRM funcionam com qualquer CRM?
Os MCPs disponíveis em /downloads cobrem integrações com plataformas específicas. Para CRMs ou ERPs fora da lista, desenvolvemos integrações sob medida — o departamento de Inteligência Artificial cuida desse tipo de projeto.
É possível usar skills em times sem que todos tenham Claude Code?
Para projetos onde parte do time não usa Claude Code, é possível expor skills como webhooks via MCP — um integrante com Claude Code executa e o resultado vai para um canal compartilhado (Slack, Discord, n8n). Não é a configuração ideal, mas funciona como ponte.
Conclusão
Claude Code puro já é potente. Com plugins, skills, hooks e MCPs, ele para de ser ferramenta e vira infraestrutura de trabalho — o tipo de coisa que, quando some, para a operação. O conjunto que documentamos aqui é o que a MaxVision usa hoje para desenvolver o site, produzir conteúdo, operar automações e auditar código. Não é experimento: é stack de produção.
Se você quer replicar parte disso, o ponto de entrada mais direto é /downloads — as versões gratuitas já dão a estrutura. Se a demanda for integração com sistemas da sua empresa (CRM, ERP, plataforma própria) ou configuração de ambiente para equipe, o departamento de Inteligência Artificial pode construir MCPs customizados. Para conversar sobre o seu cenário, entre em contato.
