Skills · Automação · n8n
Seu Claude Code virou especialista em n8n
Sete skills que carregam sozinhas e cobrem o ciclo inteiro: desenhar o workflow, configurar os nodes, escrever as expressões e resolver os erros de validação.
Sete skills que carregam sozinhas e cobrem o ciclo inteiro: desenhar o workflow, configurar os nodes, escrever as expressões e resolver os erros de validação.
Cada skill é uma pasta com um SKILL.md e arquivos de referência. O Claude Code lê a descrição, decide sozinho quando o assunto é aquele, e só então puxa o detalhe que precisa — o contexto fica leve.
Você não invoca nada à mão. Falou em webhook, expressão {{ }} ou erro de validação, a skill certa entra.
O SKILL.md é curto; catálogos de erro, padrões e referências de API só entram no contexto quando o caso pede.
Com o servidor n8n-mcp conectado, dá pra buscar nodes, validar config e publicar workflow. Sem ele, as outras seis seguem valendo.
A ordem em que as skills entram numa construção típica. O laço entre validar e corrigir costuma dar 2–3 voltas — é o normal, não é sinal de que algo deu errado.
n8n-workflow-patterns escolhe o padrão: webhook, API HTTP, banco, AI agent ou agendado.
node-configuration, expression-syntax e os dois code-* preenchem os nodes.
validation-expert lê os erros; mcp-tools-expert valida e publica no n8n.
Todas ficam em skills/ no repositório, com symlinks em .claude/skills/ — que é de onde o Claude Code carrega.
Os cinco padrões arquiteturais comprovados: processamento de webhook, integração HTTP/API, operações de banco, workflow de AI agent e tarefas agendadas.
Dispara ao desenhar ou estruturar um workflow novo.
Configuração ciente da operação: campos obrigatórios, dependências entre propriedades e qual nível de detalhe pedir no get_node.
Dispara ao configurar um node específico.
Sintaxe {{ }}, variáveis $json e $node, dados vindos de webhook e o catálogo de erros clássicos.
Dispara ao escrever ou corrigir expressões.
Code node em JavaScript: $input/$json/$node, $helpers.httpRequest, datas com DateTime e a escolha entre os modos do node.
O caminho recomendado para ~95% dos casos.
Code node em Python (beta): _input/_json, o que dá pra usar da biblioteca padrão e as limitações reais frente ao JS.
Só quando Python for mesmo necessário.
Interpretar e resolver erros de validação: catálogo de erros, perfis de validação, estrutura de operadores e como reconhecer falsos positivos.
Dispara quando um validate_* reclama.
Uso eficiente das ferramentas do MCP n8n-mcp: descoberta de nodes, validação de configuração, gestão de workflows e a biblioteca de ~2.700 templates reais.
Requer o servidor n8n-mcp conectado.
Uma pasta por skill, com SKILL.md mais os anexos: ERROR_CATALOG.md, COMMON_PATTERNS.md, DATA_ACCESS.md, FALSE_POSITIVES.md, DEPENDENCIES.md e afins.
O básico é só o Claude Code e o repositório clonado. O MCP e a instância n8n são opcionais — sem eles você perde a publicação automática, não o conhecimento.
As skills usam o mecanismo nativo de skills de projeto (.claude/skills/).
# versão instalada claude --version
Clone e abra o Claude Code de dentro da pasta — skills de projeto valem só ali.
git clone https://github.com/inematds/n8n-maker cd n8n-maker && claude
Só necessário para a skill n8n-mcp-tools-expert buscar nodes e publicar workflows.
# conferir os MCPs conectados claude mcp list
Comandos reais. O ponto principal é o passo 3: você descreve o que quer em português e as skills entram sozinhas.
As skills viajam junto com o repo — nada para instalar além disso.
git clone https://github.com/inematds/n8n-maker cd n8n-maker
Skills em .claude/skills/ são de projeto: só carregam quando a sessão roda ali dentro.
claude # de dentro de ~/projetos/n8n-maker # confira que apareceram: /skills → n8n-*
Não invoque skill nenhuma. Descreva o objetivo; o Claude escolhe o padrão e monta a estrutura.
# exemplo de pedido "monta um workflow que recebe um webhook, valida o payload e grava no Postgres" # → n8n-workflow-patterns entra com o padrão de webhook # → n8n-node-configuration configura Webhook, IF e Postgres
Ao mexer em campo dinâmico ou Code node, as skills de sintaxe e de código assumem.
# expressão em campo do node {{ $json.body.email }} # Code node (JavaScript) const items = $input.all(); return items.map(i => ({ json: { email: i.json.body.email } }));
Espere 2–3 voltas. A n8n-validation-expert traduz a mensagem, aponta a causa e separa erro real de falso positivo.
# pedido típico "valida esse workflow e corrige o que aparecer" # → erros reais: corrigidos # → falsos positivos: explicados e ignorados
Com o MCP n8n-mcp conectado, a n8n-mcp-tools-expert cria e atualiza o workflow direto no n8n.
"sobe esse workflow na minha instância do n8n"
Faça symlink das pastas para o diretório global de skills — assim continuam versionadas aqui.
ln -s ~/projetos/n8n-maker/skills/n8n-* ~/.claude/skills/
Como o roteamento acontece na prática — você fala normal, a skill certa aparece.
workflow-patterns (padrão de webhook) → node-configuration (Webhook + Slack) → expression-syntax (montar a mensagem).
$json está vindo undefined”expression-syntax mostra o acesso correto ao item e a diferença entre $json, $node e dados de webhook.
code-javascript com $helpers.httpRequest e o laço de paginação; workflow-patterns se virar um fluxo próprio.
validation-expert localiza no catálogo de erros, corrige a estrutura e diz se é caso de falso positivo.
O repositório nasceu de skills que já rodavam no perfil global; o próximo passo é ganhar exemplos executáveis e ficar mais fácil de instalar.
~/.claude/skills/ e viraram projeto: conteúdo em skills/, symlinks em .claude/skills/, README e este guia.