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.completedwebhooks, 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.