agentleFS
tmolavitmolavi/n8n-agent-skills/skills/using-n8n-skills/SKILL.md

using-n8n-skills

Skill1 starsChanged 3 months agoMITView on GitHub

Use when working with n8n workflows in any capacity. Always-on meta-skill and router for the Molavi n8n-agent-skills pack. Routes to capability skills, summarizes MCP tool families across official and community servers, and lists non-negotiable cross-cutting rules.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Never claim production-ready without stages 4–5.

    line 92

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Using n8n Skills (Molavi pack)

Maintained by Taghi Molavi · GitHub

This meta-skill is the router. Capability skills hold the real rules. Load this first on every n8n task, then invoke the matching skill via the Skill tool before writing SDK/JSON, configuring nodes, or calling MCP tools.

Non-negotiables

  1. Invoke the relevant skill before any n8n action — not only MCP calls. Designing, wiring, expressions, agents, errors, credentials: load the skill first.
  2. Validate AND verify before publish/activate — lint/validate is necessary but not sufficient. Re-fetch the workflow and inspect connections. Silent dropped wires are common.
  3. Secrets never in text fields — use n8n credentials. For HTTP Request, bind an official credential type. Never paste API keys into parameters, sticky notes, or Code nodes.
  4. Prefer live schema over training memory — n8n parameters, typeVersions, and MCP tool names drift. Trust get_node_types / node docs / lint output over recollection.
  5. Ask before side effects — test_workflow, execute_workflow, and activate can send Slack messages, write DBs, charge cards. Confirm with the user when unpinned nodes have real side effects.

Strong defaults

DefaultDetailSkill
Code node is last resortExpression → Edit Fields arrow fn → Coden8n-code-nodes
Reuse = sub-workflowSearch tagged subworkflow before buildingn8n-subworkflows
$('Node').item.json.x over bare $jsonStable across refactors and mergesn8n-expressions
Error branch on fallible nodesWebhooks need correct 4xx/5xx shapesn8n-error-handling
Lint before create/activateCatch typeVersion, AI topology, IF v1, webhooksn8n-mcp-tooling
Diagnose with execution toolsSilent 0-item drops are #1 painn8n-debugging

MCP landscape (pick what the user has)

This pack is MCP-server agnostic. Detect which tools exist in the session and adapt names.

FamilyTypical installStrength
Official n8n instance MCPn8n 2.2.0+ · Settings → Instance-level MCP · OAuth HTTPNative create/update/validate/publish, folders, SDK
AutomateLab @automatelab/n8n-mcpnpx -y @automatelab/n8n-mcp + API keyworkflow_generate, workflow_lint, execution_explain, AI agent topology
czlonkowski/n8n-mcpnpx / Docker + API keyHuge node corpus, templates, docs search
salacoste workflow-buildernpm package + multi-instanceConversational CRUD, multi-env
leonardsellem/n8n-mcp-servernpm/Docker + API keyClassic workflow/execution bridge

See n8n-mcp-tooling for routing tables and config snippets. See configs/ for ready-to-paste MCP JSON.

Skill index

SkillWhen to invoke
n8n-workflow-lifecycleStart/design/finish a workflow; naming; folders; validate→test→publish
n8n-mcp-toolingChoosing/configuring MCP servers; tool routing; multi-server setups
n8n-expressions{{}}, $json, $node, Luxon, expression errors
n8n-node-configurationAny node parameters, triggers, webhooks, Merge, Switch, HTTP, DB
n8n-code-nodesCode node decision tree + JS patterns
n8n-loopsBatching, pagination, Loop Over Items vs default per-item
n8n-agentsLangChain Agent, tools, memory, RAG, structured output
n8n-error-handlingProduction, webhooks, error workflows, response shapes
n8n-credentials-securityAuth, API keys, credential hygiene
n8n-subworkflowsReuse, tags, agent-as-tool, passthrough vs Define Below
n8n-binary-dataFiles, images, attachments, vision, binary merge
n8n-data-tablesData Tables schema, dedup, persistent state
n8n-debuggingFailures, 0 items, unresolved expressions, execution explain
n8n-ai-seo-geo-automationSEO/AEO/GEO pipelines, content ops, AI visibility workflows
n8n-production-opsMulti-env, backup, CI lint, activation policy, observability

Red flags → STOP and invoke

ThoughtAction
"Simple workflow, just build it"n8n-workflow-lifecycle
"Add a Set node to map one field"n8n-expressions (usually inline)
"Code node is easier"n8n-code-nodes
"Validation passed → publish"Lifecycle checklist + re-fetch connections
"Agent looks wired"n8n-agents tool name/description quality
"Loop Over Items for each row"n8n-loops (default iteration often enough)
"Paste the API key in the header"n8n-credentials-security
"Why is this empty?"n8n-debugging + execution explain

Session protocol

  1. Confirm n8n goal (build / fix / audit / automate SEO-GEO / ops).
  2. Detect available MCP tools; if none, offer config from configs/ or guide JSON-only + lint path.
  3. Load this router + the 1–3 matching capability skills.
  4. Plan → build → lint/validate → verify connections → test (with consent) → activate/publish → handoff notes.
  5. Never claim production-ready without stages 4–5.

Related Molavi projects

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.