Aller au contenu

n8n Code Tool skill

Écrivez des Custom Code Tools n8n appelables par agent, avec query et sortie chaîne.

Communauté · Romuald Członkowski
AuteurRomuald Członkowski
LicenceMIT
Sourceczlonkowski/n8n-skills · SKILL.md sur GitHub
Site du projetdocs.n8n.io
Fonctionne dansClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lu à la source le

n8n Code Tool skill: Écrivez des Custom Code Tools n8n appelables par agent, avec query et sortie chaîne.

Distinguez le sandbox d’outil du nœud Code et concevez des arguments structurés.

Extrait du SKILL.md du skill : # n8n Custom Code Tool

Ceci est un skill de la communauté créé par Romuald Członkowski, vérifié ni par nous ni par Anthropic. Un skill peut demander à l’agent d’exécuter du code, de lire des fichiers ou d’accéder au réseau. Avant de l’installer, lisez son SKILL.md et chaque script du dossier, et cherchez tout ce qui ne correspond pas à ce qu’il prétend faire.

Ce qu’il fait

  1. Distinguez le sandbox d’outil du nœud Code et concevez des arguments structurés.

Ce que vous obtenez

  • Code Tool, plans de schéma d’entrée et corrections de types de sortie.

Quand l’utiliser

  • Corrige ce Code Tool qui renvoie un tableau au lieu d’une chaîne.

Quand ne pas l’utiliser

  • Prendre les instructions pour une garantie de réussite d’un service, d’une validation ou d’un déploiement.

Ce qu’il faut

  • Nécessite un serveur n8n-mcp compatible et de vraies données. La gestion exige une instance autorisée ; services et hébergement peuvent être payants.

Fichiers du skill

Fichier ou dossierÀ quoi il sert
SKILL.mdInstructions et procédure propre à la tâche.
INPUT_SCHEMA.mdRéférence complémentaire utilisée par ce processus.
ERROR_PATTERNS.mdRéférence complémentaire utilisée par ce processus.

Licence trouvée dans le dépôt le 2026-11-17 : MIT.

Exemples de prompts

Tapez l’un de ces prompts après l’installation ; nommer le skill garantit qu’il sera utilisé.

  • Corrige ce Code Tool qui renvoie un tableau au lieu d’une chaîne.
  • Définis des arguments structurés pour ce calcul appelé par agent.
  • Remplace $fromAI ou $input indisponibles dans cet outil.

Comment installer n8n-code-tool

Préparer le workflow

Le lien mène à la documentation n8n, pas à l’installateur MCP communautaire. Installez n8n-mcp séparément ; hébergement et services peuvent être payants. Examinez les hooks.

Copier le dossier dans un autre agent n’installe pas les hooks Claude Code. Vérifiez le schéma actuel et les écritures avant exécution.

Un skill est un dossier contenant un fichier SKILL.md. Vous l’installez une fois ; l’agent lit sa courte description au début de chaque session et ne charge les instructions complètes que si une demande correspond. Choisissez l’environnement que vous utilisez :

Claude Code : depuis la marketplace de plugins

  1. Lancez Claude Code dans un terminal avec claude.
  2. Ajoutez la marketplace (une fois par ordinateur) :
    /plugin marketplace add czlonkowski/n8n-skills
  3. Installez le plugin. Claude Code affiche d’abord ses détails : vérifiez ce qu’il va ajouter (skills, hooks, serveurs MCP), puis choisissez s’il est pour vous, pour toutes les personnes de ce dépôt, ou pour vous seul dans ce dépôt.
    /plugin install n8n-mcp-skills@n8n-mcp-skills
  4. Tapez / et cherchez /n8n-mcp-skills:n8n-code-tool, ou demandez simplement la tâche.

Depuis votre shell plutôt que dans une session :

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

Le plugin s’installe en bloc : d’autres skills sont donc installés avec lui, dont 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 : copier le dossier dans votre dossier de skills

Placez le dossier du skill dans ~/.claude/skills/ pour l’utiliser dans tous les projets de cet ordinateur, ou dans .claude/skills/ à l’intérieur d’un dépôt pour le partager avec toutes les personnes qui y travaillent (committez-le).

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 détecte pendant la session les skills nouveaux ou modifiés dans ces dossiers. Si le dossier de skills n’existait pas au démarrage de la session, lancez /reload-skills une fois. Tapez ensuite /n8n-code-tool ou décrivez simplement la tâche.

Sous Windows, lancez les commandes dans Git Bash ou WSL, ou copiez le dossier au même endroit avec l’Explorateur de fichiers.

Codex, Gemini CLI, Cursor et GitHub Copilot

Ces agents lisent les mêmes dossiers SKILL.md. Le seul dossier que les quatre acceptent dans un projet est .agents/skills/ ; cette commande y copie donc le 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/
AgentDossier du projetVotre dossier utilisateurRemarques
OpenAI Codex
.agents/skills/
~/.agents/skills/
Tapez $ ou lancez /skills pour choisir un skill ; Codex en choisit aussi un quand votre tâche correspond.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou installez-le depuis Git avec gemini skills install <git URL> --path <folder> --consent. Le 18 juin 2026, Google a remplacé Gemini CLI par Antigravity CLI pour les utilisateurs de l’offre gratuite et de Google One ; Antigravity utilise .agents/skills/ dans un projet et ~/.gemini/config/skills/ pour vous.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Tapez / dans le chat Agent pour choisir un skill. Cursor lit aussi les dossiers .claude/skills/ de Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Fonctionne dans Copilot CLI, l’agent cloud et le mode agent de VS Code, Visual Studio et JetBrains (la prise en charge dans l’IDE dépend de la version). Ou lancez gh skill install OWNER/REPOSITORY SKILL (préversion publique, GitHub CLI 2.90.0 ou ultérieure).
N’installez que des skills de confiance. Anthropic conseille de n’utiliser que des skills provenant de sources de confiance, et de lire chaque fichier de tout autre skill avant de l’utiliser : un skill peut amener l’agent à exécuter des commandes, lire des fichiers ou envoyer des données d’une manière que sa description ne mentionne pas.

Sources de ces étapes

Vérifiées dans la documentation de chaque éditeur le 2026-11-14 :

Contrat d’entrée

Les outils simples reçoivent query ; les structurés valident des arguments nommés. Adaptez le schéma aux données réelles et nommez clairement l’outil.

Frontière de l’outil

Ne copiez pas le modèle Code. Vérifiez sortie chaîne et connexion ai_tool avec les entrées réelles de l’agent.

Questions sur n8n-code-tool

Ce site exécute-t-il le skill ?

Non. Guide fondé sur les sources ; votre agent l’exécute dans son environnement configuré.

Les parcours cloud complets sont-ils vérifiés ?

Non. Chargement générique et exécution API sont omis ; prérequis locaux et capacités de l’hôte restent nécessaires.

Code Tool renvoie-t-il des éléments JSON ?

Non. JavaScript lit query et Python _query. Renvoyez une chaîne, avec sérialisation JSON pour les résultats structurés.

Peut-il utiliser les utilitaires Code classiques ?

Non. $input, $json, $helpers et $fromAI sont absents. Utilisez un sous-workflow ou HTTP Request Tool si nécessaire.

Plus de skills IA

Skills similaires

Catégories de skills