n8n-expert

n8n-expert is an agent for Claude Code from jeremylongshore/tons-of-skills-marketplace. It costs 61 tokens per session (2,372 once invoked), scanned A, original, MIT.

An assistant for designing n8n workflows, which are automations made from connected steps called nodes. It covers branching, loops, custom JavaScript, error handling, and importable workflow definitions.

In plain words
What is it for?
Use it to design self-hosted n8n automations with webhooks, AI services, branching, retries, and JavaScript code nodes.
Why use it?
It helps turn a complex automation requirement into a structured workflow. It also addresses failures and repeated processing that simple step-by-step automations may not handle well.

Agent for Claude Code

Written for Claude Code: background in frontmatter. Also seen: model in frontmatter; positional $N argument.

Part of the n8n-workflow-designer plugin — 1 command, 1 agent shipped together

Good fit Use it to design self-hosted n8n automations with webhooks, AI services, branching, retries, and JavaScript code nodes.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/jeremylongshore/tons-of-skills-marketplace/n8n-expert
About the project

Tons of Skills is a model-agnostic marketplace that distributes reusable skills, plugins, agents, commands, hooks, and settings for coding-agent tools. It is intended for people who want to browse, install, and manage agent extensions, with Claude Code as its verified native harness. The catalogue entries are extensions provided by or associated with this marketplace.

jeremylongshore/tons-of-skills-marketplace · 2,881 stars · on GitHub · tonsofskills.com

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace

Made for: Claude Code.

Or install n8n-workflow-designer, the plugin that ships this one along with the rest of its 1 command, 1 agent.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for n8n-expert

README.md
[![agentmods](https://agentmods.dev/badge/agents/jeremylongshore/tons-of-skills-marketplace/n8n-expert/github.svg)](https://agentmods.dev/agents/jeremylongshore/tons-of-skills-marketplace/n8n-expert)
Your own site
<a href="https://agentmods.dev/agents/jeremylongshore/tons-of-skills-marketplace/n8n-expert"><img src="https://agentmods.dev/badge/agents/jeremylongshore/tons-of-skills-marketplace/n8n-expert/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for n8n-expert

Your own site · 80×15
<a href="https://agentmods.dev/agents/jeremylongshore/tons-of-skills-marketplace/n8n-expert"><img src="https://agentmods.dev/badge/agents/jeremylongshore/tons-of-skills-marketplace/n8n-expert.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 61 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,372 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00061 $0.02372
Opus 5.5 $0.00024 $0.00949
Sonnet 5.5 $0.00012 $0.00474
Haiku 4.5 $0.00006 $0.00237

Measured 1mo ago against content hash decf4be2b64a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

n8n-expert scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/ai-agency/n8n-workflow-designer/agents/n8n-expert.md · 395 lines

How it starts

The opening of the file, as written. The whole thing — 395 lines — stays where its author put it; the contents beside it link to each section on GitHub.

n8n Workflow Expert

You are an expert n8n workflow designer who helps build complex automation workflows. n8n is more powerful than Make/Zapier because it's:

  • Self-hostable (no vendor lock-in)
  • Has loops and iterations
  • Supports complex branching
  • Allows custom JavaScript code
  • Much cheaper at scale

When User Mentions n8n, Workflows, or Complex Automation

Offer to design their n8n workflow with:

1. Workflow Architecture

Design workflows with clear node structure:

{
  "name": "Example Workflow",
  "nodes": [
    {
      "name": "Webhook Trigger",
      "type": "n8n-nodes-base.webhook",
      "position": [250, 300],
      "parameters": {
        "path": "webhook-endpoint",
        "responseMode": "onReceived",
        "responseData": "allEntries"
      }
    },
    {
      "name": "OpenAI",
      "type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
      "position": [450, 300],
      "parameters": {
        "model": "gpt-4",
        "prompt": "Analyze this data"
      }
    }
  ],
  "connections": {
    "Webhook Trigger": {
      "main": [["OpenAI"]]
    }
  }
}

2. Error Handling Patterns

Retry with Exponential Backoff:

// In Function node
const maxRetries = 3;
const baseDelay = 1000; // 1 second

for (let i = 0; i < maxRetries; i++) {
  try {
    // Your API call here
    const result = await $http.request(options);
    return result;
  } catch (error) {
    if (i === maxRetries - 1) throw error;
    await new Promise(resolve =>
      setTimeout(resolve, baseDelay * Math.pow(2, i))
    );
  }
}

Error Notifications:

// Send error notification on failure
if ($input.item.json.error) {
  return [{
    json: {
      to: '[email protected]',
      subject: 'Workflow Error',
      body: `Error in workflow: ${$input.item.json.error}`
    }
  }];
}

3. Common Workflow Patterns

Pattern 1: AI Content Pipeline

RSS Feed → Filter New Items → OpenAI Enhancement → Format → Publish to CMS

Read the full file on GitHub · 395 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 395 lines · 61 tokens per session scan A decf4be2b64a

Subscribe to this mod's changes

n8n-expert is an agent published in the GitHub repository jeremylongshore/tons-of-skills-marketplace (2,881 stars, last pushed today), licensed MIT. It adds 61 tokens to every session and 2,372 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other agents, from other repositories

developer

Use this agent for any n8n development task - frontend (Vue 3), backend (Node.js/TypeScript), workflow engine, node creation, or full-stack features. The agent automatically applies n8n conventions and best practices. Examples: user: 'Add a new button to the workflow editor' assistant: 'I'll use the developer agent to…

n8n-io/n8n · 0 tokens

linear-issue-triager

Use this agent proactively when a Linear issue is created, updated, or needs comprehensive analysis. This agent performs thorough issue investigation and triage including root cause analysis, severity assessment, and implementation scope identification.

n8n-io/n8n · 47 tokens

scg-mapper

Maps a set of connectors into the Source Capability Graph (SCG) via a deterministic state machine — introspect, parse structure, link entities, finalize. Indexes reachability only, never the data behind it.

bearlike/Assistant · 48 tokens

n8n-author

Writes or edits an n8n Decorator-TS .workflow.ts file from verified node contracts, or fixes a file from validation/wiring errors. The only file-writing agent in the build-workflow-v2 pipeline. Never validates or pushes — the orchestrator gates that.

neurawork-git/n8n-autopilot · 60 tokens

n8n-node-verifier

Produces the VERIFIED parameter contract for a single n8n node type by reading its real schema via npx n8nac skills node-info --json. Adversarial — omits any param key it is not certain exists, because n8n silently ignores wrong keys at runtime. Read-only. Used in the Research fan-out of build-workflow-v2 to kill the.

neurawork-git/n8n-autopilot · 83 tokens

n8n-workflow-builder

Expert n8n workflow architect and builder. Use after onboarding is complete. Knows the full project context from CLAUDE.md, all workflow specs from PRD.md, architecture from DESIGN.md, and all 7 n8n skills. TRIGGERS — invoke when: building a new workflow, debugging a broken node, writing Code node JS/Python, designing…

walidboulanouar/n8n-claude-code-template · 0 tokens