Vai al contenuto

n8n Code Tool skill

Scrivi Custom Code Tool n8n per agenti con query e uscita stringa.

Community · Romuald Członkowski
AutoreRomuald Członkowski
LicenzaMIT
Fonteczlonkowski/n8n-skills · SKILL.md su GitHub
Sito del progettodocs.n8n.io
Funziona inClaude Code · Codex, Gemini CLI, Cursor, Copilot
Letta dalla fonte il

n8n Code Tool skill: Scrivi Custom Code Tool n8n per agenti con query e uscita stringa.

Distingui sandbox degli strumenti e nodi Code e progetta argomenti strutturati.

Dallo SKILL.md della skill: # n8n Custom Code Tool

Questa è una skill della community di Romuald Członkowski, non verificata da noi né da Anthropic. Le skill possono dire all'agente di eseguire codice, leggere file o accedere alla rete. Prima di installarla, leggi il suo SKILL.md e ogni script nella cartella, e cerca qualsiasi cosa che non corrisponda a ciò che dichiara di fare.

Cosa fa

  1. Distingui sandbox degli strumenti e nodi Code e progetta argomenti strutturati.

Cosa ottieni

  • Codice Code Tool, schemi di input e correzioni dei tipi di uscita.

Quando usarla

  • Correggi questo Code Tool che restituisce un array anziché una stringa.

Quando non usarla

  • Considerare le istruzioni una garanzia di successo di servizi, verifiche o pubblicazioni.

Cosa richiede

  • Richiede un server n8n-mcp compatibile e dati reali. La gestione richiede un’istanza n8n autorizzata; servizi e hosting possono avere costi separati.

File della skill

File o cartellaA cosa serve
SKILL.mdIstruzioni e flusso specifico.
INPUT_SCHEMA.mdRiferimento complementare usato dal flusso.
ERROR_PATTERNS.mdRiferimento complementare usato dal flusso.

Licenza trovata nel repository il 2026-11-17: MIT.

Prompt di esempio

Scrivine uno dopo l'installazione; nominare la skill fa sì che venga usata.

  • Correggi questo Code Tool che restituisce un array anziché una stringa.
  • Definisci argomenti strutturati per questo calcolo dell’agente.
  • Sostituisci $fromAI o $input non disponibili in questo strumento.

Come installare n8n-code-tool

Preparare il flusso

Il link porta ai documenti n8n, non all’installer MCP comunitario. Installa n8n-mcp separatamente; hosting e servizi possono costare. Controlla gli hook.

Copiare la cartella in un altro agente non installa gli hook Claude Code. Verifica lo schema attuale e le scritture prima dell’esecuzione.

Una skill è una cartella con un file SKILL.md. La installi una volta sola; l'agente legge la sua breve descrizione all'inizio di ogni sessione e carica le istruzioni complete solo quando una richiesta corrisponde. Scegli dove la usi:

Claude Code: dal marketplace dei plugin

  1. Avvia Claude Code in un terminale con claude.
  2. Aggiungi il marketplace (una volta per computer):
    /plugin marketplace add czlonkowski/n8n-skills
  3. Installa il plugin. Claude Code ne mostra prima i dettagli: controlla cosa aggiungerà (skill, hook, server MCP), poi scegli se è per te, per tutti su questo repository o solo per te in questo repository.
    /plugin install n8n-mcp-skills@n8n-mcp-skills
  4. Digita / e cerca /n8n-mcp-skills:n8n-code-tool, oppure chiedi semplicemente di svolgere il compito.

Dalla shell invece che da una sessione:

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

Il plugin si installa per intero, quindi arrivano anche altre skill, tra cui 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-agents, n8n-expression-syntax, n8n-error-handling, n8n-validation-expert, n8n-mcp-tools-expert.

Claude Code: copia la cartella nella tua cartella delle skill

Metti la cartella della skill in ~/.claude/skills/ per usarla in tutti i progetti su questo computer, oppure in .claude/skills/ dentro un repository per condividerla con chiunque ci lavori (fanne il commit).

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

Claude Code rileva le skill nuove o modificate in queste cartelle durante la sessione. Se la cartella delle skill non esisteva quando è iniziata la sessione, esegui una volta /reload-skills. Poi digita /n8n-code-tool o descrivi semplicemente il compito.

Su Windows, esegui i comandi in Git Bash o WSL, oppure copia la cartella nello stesso percorso con Esplora file.

Codex, Gemini CLI, Cursor e GitHub Copilot

Questi agenti leggono le stesse cartelle SKILL.md. L'unica cartella di progetto accettata da tutti e quattro è .agents/skills/, quindi questo comando ci copia la skill:

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-code-tool .agents/skills/
AgenteCartella del progettoLa tua cartella utenteNote
OpenAI Codex
.agents/skills/
~/.agents/skills/
Digita $ o esegui /skills per scegliere una skill; Codex ne sceglie una anche da solo quando il tuo compito corrisponde.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Oppure installa da Git con gemini skills install <git URL> --path <folder> --consent. Il 18 giugno 2026 Google ha sostituito Gemini CLI con Antigravity CLI per gli utenti del piano gratuito e di Google One; Antigravity usa .agents/skills/ in un progetto e ~/.gemini/config/skills/ per te.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Digita / nella chat Agent per scegliere una skill. Cursor legge anche le cartelle .claude/skills/ di Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funziona in Copilot CLI, nel cloud agent e nella modalità agente di VS Code, Visual Studio e JetBrains (il supporto negli IDE dipende dalla versione). Oppure esegui gh skill install OWNER/REPOSITORY SKILL (anteprima pubblica, GitHub CLI 2.90.0 o successiva).
Installa solo skill di cui ti fidi. Anthropic consiglia di usare solo skill di fonti affidabili e di leggere ogni file di qualsiasi altra skill prima di usarla: una skill può indurre l'agente a eseguire comandi, leggere file o inviare dati in modi che la sua descrizione non menziona.

Fonti per questi passaggi

Verificati sulla documentazione di ciascun fornitore il 2026-11-14:

Contratto di input

Gli strumenti semplici ricevono query; quelli strutturati validano argomenti nominati. Allinea lo schema ai dati reali e usa nomi descrittivi.

Confine dello strumento

Non copiare modelli Code. Verifica uscita stringa e collegamento ai_tool con input reali dell’agente.

Domande su n8n-code-tool

Questo sito esegue lo skill?

No. Guida basata sulle fonti; il tuo agente lo esegue nel suo ambiente configurato.

Flussi cloud completi verificati?

No. Caricamento generico ed esecuzione API sono omessi; restano necessari requisiti locali e capacità dell’host.

Code Tool restituisce elementi JSON?

No. JavaScript legge query e Python _query. Restituisci stringhe, serializzando JSON per risultati strutturati.

Può usare normali helper Code?

No. $input, $json, $helpers e $fromAI non sono presenti. Usa sotto-workflow o HTTP Request Tool se necessario.

Altre skill IA

Skill correlate

Categorie di skill