czlonkowski /n8n-skills

n8n skillset for Claude Code to build flawless n8n workflows

★ 6,651⑂ 1,082👁 64⑃ 39● 32▤ 7
ShellMITCreated 2025-10-20www.n8n-skills.com
TA的项目
下载:v1.37.1 — native-first node selectionv1.37.1 ↓1.37.12026-10-24
+6
日增长
6,651
stars
1,082
forks
64
watchers
39
prs
32
issues
7
releases

README

n8n-skills

Expert Claude Code skills for building flawless n8n workflows using the n8n-mcp MCP server






 Watch the Introduction Video



 💼 Need it built for you? Work with AiAdvisors — n8n automation audits, builds, and operations, run by the author of n8n-mcp and n8n-skills.

---

 🎯 What is this?

This repository contains 14 complementary Claude Code skills — plus an always-on router skill and a hooks enforcement layer — that teach AI assistants how to build production-ready n8n workflows using the n8n-mcp MCP server, and how to deploy the self-hosted n8n that runs them.

 Why These Skills Exist

Building n8n workflows programmatically can be challenging. Common issues include:
- Using MCP tools incorrectly or inefficiently
- Getting stuck in validation error loops
- Not knowing which workflow patterns to use
- Misconfiguring nodes and their dependencies

These skills solve these problems by teaching Claude:
- ✅ Correct n8n expression syntax ({{}} patterns)
- ✅ How to use n8n-mcp tools effectively
- ✅ Proven workflow patterns from real-world usage
- ✅ Validation error interpretation and fixing
- ✅ Operation-aware node configuration

---

 📚 The 14 Skills

 1. n8n Expression Syntax
Teaches correct n8n expression syntax and common patterns.

Activates when: Writing expressions, using {{}} syntax, accessing $json/$node variables, troubleshooting expression errors.

Key Features:
- Core variables ($json, $node, $now, $env)
- Critical gotcha: Webhook data is under $json.body
- Common mistakes catalog with fixes
- The transform gatekeeper: service node → native node → short expression → Code; a function body in {{ }} is code
- Built-in helpers (.pluck(), .sum(), $ifEmpty(), .diffTo()), expression-only

 2. n8n MCP Tools Expert (HIGHEST PRIORITY)
Expert guide for using n8n-mcp MCP tools effectively.

Activates when: Searching for nodes, validating configurations, accessing templates, managing workflows.

Key Features:
- Tool selection guide (which tool for which task)
- nodeType format differences (nodes-base. vs n8n-nodes-base.)
- Validation profiles (minimal/runtime/ai-friendly/strict)
- Smart parameters (branch="true" for IF nodes)
- Auto-sanitization system explained

Most Important: Teaches correct MCP tool usage patterns and parameter formats

 3. n8n Workflow Patterns
Build workflows using 5 proven architectural patterns.

Activates when: Creating workflows, connecting nodes, designing automation.

Key Features:
- 5 proven patterns (webhook processing, HTTP API, database, AI, scheduled)
- Workflow creation checklist
- Real examples from 2,653+ n8n templates
- Connection best practices
- Pattern selection guide

 4. n8n Validation Expert
Interpret validation errors and guide fixing.

Activates when: Validation fails, debugging workflow errors, handling false positives.

Key Features:
- Validation loop workflow
- Real error catalog
- Auto-sanitization behavior explained
- False positives guide
- Profile selection for different stages

 5. n

Top issues

Latest release

v1.37.1 — native-first node selection v1.37.1 2026-10-24
The first release with native-first node selection (70, PRs 71 and 72). It also ships the unreleased 1.36.0 per-call instance docs. Built to match n8n-mcp 2.97.0 (czlonkowski/n8n-mcp1194).

 Native first, Code last
- Router (using-n8n-mcp-skills): pick in this order: the service's own node (HTTP Request only when no node covers the operation), then a native node for the job, then a short expression in that node, then Code. A job-to-node table names the node for each common job (Summarize, Aggregate, Split Out, Merge, Compare Datasets, Remove Duplicates, Sort + Limit, Date & Time, XML / HTML / 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON