Pular para o conteúdo

n8n Agents skill

Projete agentes n8n com ferramentas, memória, saída estruturada e revisão humana.

Comunidade · Romuald Członkowski
AutorRomuald Członkowski
LicençaMIT
Fonteczlonkowski/n8n-skills · SKILL.md no GitHub
Site do projetodocs.n8n.io
Funciona emClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lido na fonte em

n8n Agents skill: Projete agentes n8n com ferramentas, memória, saída estruturada e revisão humana.

Use agentes só quando ferramentas ou conversa justificarem e verifique conexões AI tipadas.

Do SKILL.md da skill: # n8n Agents

Esta é uma skill da comunidade, de Romuald Członkowski, sem verificação nossa nem da Anthropic. Skills podem mandar o agente executar código, ler arquivos ou acessar a rede. Antes de instalar, leia o SKILL.md e todos os scripts da pasta, e procure qualquer coisa que não corresponda ao que ela diz fazer.

O que ela faz

  1. Use agentes só quando ferramentas ou conversa justificarem e verifique conexões AI tipadas.

O que você recebe

  • Grafos de agentes, descrições, chaves estáveis e fluxos revisados.

Quando usar

  • Substitua Agent mais Switch pelo classificador adequado.

Quando não usar

  • Tratar instruções como garantia de sucesso de serviço, validação ou implantação.

O que ela exige

  • Exige servidor n8n-mcp compatível e dados reais. A gestão requer instância n8n autorizada; serviços e hospedagem podem ter custos separados.

Arquivos da skill

Arquivo ou pastaPara que serve
SKILL.mdInstruções e fluxo específico.
TOOLS.mdReferência complementar usada neste fluxo.
MEMORY.mdReferência complementar usada neste fluxo.
HUMAN_REVIEW.mdReferência complementar usada neste fluxo.
STRUCTURED_OUTPUT.mdReferência complementar usada neste fluxo.

Licença conforme encontrada no repositório em 2026-11-17: MIT.

Prompts de exemplo

Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.

  • Substitua Agent mais Switch pelo classificador adequado.
  • Revise descrições, conexões ai_tool e chaves de sessão.
  • Adicione revisão humana que mostre os argumentos reais.

Como instalar a skill n8n-agents

Preparar o fluxo

O link é da documentação n8n, não do instalador MCP comunitário. Instale n8n-mcp à parte; hospedagem e serviços podem custar. Revise os hooks.

Copiar a pasta para outro agente não instala hooks do Claude Code. Revise o esquema atual e as gravações antes de executar.

Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:

Claude Code: pelo marketplace de plugins

  1. Abra o Claude Code em um terminal com claude.
  2. Adicione o marketplace (uma vez por computador):
    /plugin marketplace add czlonkowski/n8n-skills
  3. Instale o plugin. O Claude Code mostra os detalhes primeiro: confira o que ele vai adicionar (skills, hooks, servidores MCP) e escolha se ele é para você, para todos neste repositório ou só para você neste repositório.
    /plugin install n8n-mcp-skills@n8n-mcp-skills
  4. Digite / e procure /n8n-mcp-skills:n8n-agents, ou simplesmente peça a tarefa.

Pelo shell, em vez de dentro de uma sessão:

claude plugin marketplace add czlonkowski/n8n-skills
claude plugin install n8n-mcp-skills@n8n-mcp-skills

O plugin é instalado inteiro, então outras skills vêm junto, incluindo n8n-subworkflows, n8n-multi-instance, n8n-self-hosting, n8n-binary-and-data, n8n-node-configuration, n8n-code-javascript, n8n-workflow-patterns, using-n8n-mcp-skills, n8n-code-python, n8n-expression-syntax, n8n-error-handling, n8n-validation-expert, n8n-mcp-tools-expert, n8n-code-tool.

Claude Code: copie a pasta para a sua pasta de skills

Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p ~/.claude/skills
cp -R n8n-skills/skills/n8n-agents ~/.claude/skills/

O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /n8n-agents ou apenas descreva a tarefa.

No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.

Codex, Gemini CLI, Cursor e GitHub Copilot

Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-agents .agents/skills/
AgentePasta do projetoSua pasta de usuárioObservações
OpenAI Codex
.agents/skills/
~/.agents/skills/
Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente).
Instale só skills em que você confia. A recomendação da Anthropic é usar skills apenas de fontes confiáveis e ler todos os arquivos de qualquer outra skill antes de usá-la: uma skill pode mandar o agente executar comandos, ler arquivos ou enviar dados de formas que a descrição não menciona.

Fontes destas instruções

Conferido com a documentação de cada fornecedor em 2026-11-14:

Ferramentas e memória

Use nomes e descrições concretos. Conecte modelo, memória e ferramentas por ai_* e chaves estáveis para não misturar conversas.

Saída e ações

Parser e corretor precisam de testes, sem garantir resultados corretos. Antes de ações externas, a revisão deve mostrar parâmetros reais.

Perguntas sobre a skill n8n-agents

Este site executa o skill?

Não. Guia baseado nas fontes; seu agente executa no ambiente configurado.

Fluxos completos de nuvem foram verificados?

Não. Upload genérico e execução API são omitidos; requisitos locais e capacidades do host continuam necessários.

Toda tarefa IA exige um Agent?

Não. Classificadores, extratores, cadeias e nós multimídia podem ser mais simples. Use agentes para ferramentas ou conversa.

A identidade deve vir de $fromAI?

Não. Vincule identidade, sessão e limites a contexto confiável; não deixe o modelo decidir esses valores.

Mais skills de IA

Skills relacionadas

Categorias de skills