n8n-claude-skills

Production-grade Claude Skills for building, debugging, and shipping n8n workflows — distilled from 100+ production workflows by an n8n Verified Creator.

Give Claude Code the instincts of a senior n8n engineer. No more hallucinated node types, broken expressions, or toy demos.

# 60-second install
npx n8n-claude-skills install

Then in Claude Code:

"Build me an n8n workflow that ingests leads from a webhook, enriches them via SerpAPI → Apollo waterfall, scores spam with a composite check, and writes qualified leads to Google Sheets."

Claude now builds a real, production-shaped workflow — correct node types, proper expressions, checkpoint tables, error branches, and retry logic. Not a Figma mockup of a workflow. A workflow.

---

What's in the box

Skill	What it does	When it fires
workflow-architect	Designs n8n workflows from requirements. Picks the right nodes, structures branches, and wires error paths.	"build a workflow that…", "design an automation for…"
chain-llm-pattern	The Groq/OpenAI chain_llm pattern for multi-step LLM reasoning (entity extraction → categorization → scoring).	"extract structured data with LLMs", "multi-step prompt chain"
enrichment-waterfall	Multi-vendor enrichment waterfalls (SerpAPI → Hunter → Apollo → LLM fallback) with cost-aware fallbacks.	"lead enrichment", "data waterfall", "Clay alternative"
mysql-checkpointing	Production MySQL patterns: batch processing, duplicate prevention, resumable pipelines, dynamic table creation.	"idempotent pipeline", "checkpoint table", "batch processing"
debug-workflow	Systematic n8n debugging: expression syntax, pinned data, sub-workflow isolation, execution log reading.	"why is my workflow failing", "debug this n8n error"

More shipping weekly. PRs welcome.

---

Why this exists

LLMs confidently hallucinate n8n. They invent node types (Googlesheets instead of Google Sheets), mix up expression syntax ({{$json["x"]}} vs ={{ $json.x }}), forget about sub-workflows, and ship demos that collapse the moment you plug in real data.

This pack teaches Claude the patterns that actually survive production — the ones we use in:

• Real estate financial reporting (Google Sheets → Claude API → PDF → Gmail)
• Multi-language call transcript pipelines (EN/ES/PT, Groq chain_llm)
• Composite spam scoring with Twilio retry logic
• 47-node batch processing with duplicate prevention
• WhatsApp commerce agents with Stripe + Meta Cloud API

You get the instincts, not the code.

---

Install

Claude Code (recommended)

# Clone and install to your user skills directory
git clone https://github.com/masteranime/n8n-claude-skills.git
cd n8n-claude-skills
./install.sh

Claude Code picks up the skills automatically.

Manual (any Skills-compatible agent)

Copy any folder inside skills/ into your agent's skills directory. Each folder is a self-contained skill with a SKILL.md and optional reference files.

Works with: Claude Code, Cursor, Codex, Gemini CLI, Opencode, and anything following the Agent Skills spec.

---

Quick demo

Prompt:

Build an n8n workflow that receives Stripe checkout.session.completed webhooks, looks up the customer in our MySQL orders table, sends a WhatsApp confirmation via Meta Cloud API, and retries via Twilio SMS if WhatsApp fails.

Without this pack: Claude writes pseudocode, invents Whatsapp Node, forgets the retry branch, skips the idempotency check.

With this pack: Claude produces a 14-node workflow JSON you can paste into n8n — with webhook signature verification, a MySQL processed_webhooks checkpoint, proper Meta Cloud API messages endpoint, an IF branch on WhatsApp failure feeding into Twilio with exponential backoff, and an error trigger sub-workflow.

Full example: examples/stripe-whatsapp-fallback.json

---

Who built this

Muhammad Shaheer — n8n Verified Creator (100+ workflows), Claude Code daily user, 4+ years shipping production AI automation.

These skills are extracted from real client work — real estate finance pipelines, multi-language NLP, voice lead automation, lead enrichment waterfalls. If a pattern is in here, it shipped to a paying customer first.

---

Contributing

Have a battle-tested n8n pattern? Open a PR. See CONTRIBUTING.md for the skill format and review criteria.

Good additions:

• Domain skills (e-commerce flows, real estate, healthcare)
• Integration skills (specific SaaS tools)
• Debug recipes for common footguns

License

MIT. Use it, fork it, ship it. Credit appreciated but not required.

---

⭐ Star the repo if this saved you an hour of debugging n8n expressions.