[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73408":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":16,"starSnapshotCount":16,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},73408,"n8n-skills","czlonkowski\u002Fn8n-skills","czlonkowski","n8n skillset for Claude Code to build flawless n8n workflows","https:\u002F\u002Fwww.n8n-skills.com",null,"Shell",5374,917,61,5,0,56,144,452,168,39.89,"MIT License",false,"main",true,[27,28,29],"ai-agents","n8n","workflow-automation","2026-06-12 02:03:13","# n8n-skills\n\n**Expert Claude Code skills for building flawless n8n workflows using the n8n-mcp MCP server**\n\n[![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fczlonkowski\u002Fn8n-skills?style=social)](https:\u002F\u002Fgithub.com\u002Fczlonkowski\u002Fn8n-skills)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](LICENSE)\n[![n8n-mcp](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fn8n--mcp-compatible-green.svg)](https:\u002F\u002Fgithub.com\u002Fczlonkowski\u002Fn8n-mcp)\n\n## Watch the Introduction Video\n\n[![n8n Skills Introduction](skills.png)](https:\u002F\u002Fyoutu.be\u002Fe6VvRqmUY2Y?si=6Igply3cadjO6Xx0)\n\n---\n\n## 🎯 What is this?\n\nThis repository contains **7 complementary Claude Code skills** that teach AI assistants how to build production-ready n8n workflows using the [n8n-mcp](https:\u002F\u002Fgithub.com\u002Fczlonkowski\u002Fn8n-mcp) MCP server.\n\n### Why These Skills Exist\n\nBuilding n8n workflows programmatically can be challenging. Common issues include:\n- Using MCP tools incorrectly or inefficiently\n- Getting stuck in validation error loops\n- Not knowing which workflow patterns to use\n- Misconfiguring nodes and their dependencies\n\nThese skills solve these problems by teaching Claude:\n- ✅ Correct n8n expression syntax ({{}} patterns)\n- ✅ How to use n8n-mcp tools effectively\n- ✅ Proven workflow patterns from real-world usage\n- ✅ Validation error interpretation and fixing\n- ✅ Operation-aware node configuration\n\n---\n\n## 📚 The 7 Skills\n\n### 1. **n8n Expression Syntax**\nTeaches correct n8n expression syntax and common patterns.\n\n**Activates when**: Writing expressions, using {{}} syntax, accessing $json\u002F$node variables, troubleshooting expression errors.\n\n**Key Features**:\n- Core variables ($json, $node, $now, $env)\n- **Critical gotcha**: Webhook data is under `$json.body`\n- Common mistakes catalog with fixes\n- When NOT to use expressions (Code nodes!)\n\n### 2. **n8n MCP Tools Expert** (HIGHEST PRIORITY)\nExpert guide for using n8n-mcp MCP tools effectively.\n\n**Activates when**: Searching for nodes, validating configurations, accessing templates, managing workflows.\n\n**Key Features**:\n- Tool selection guide (which tool for which task)\n- nodeType format differences (nodes-base.* vs n8n-nodes-base.*)\n- Validation profiles (minimal\u002Fruntime\u002Fai-friendly\u002Fstrict)\n- Smart parameters (branch=\"true\" for IF nodes)\n- Auto-sanitization system explained\n\n**Most Important**: Teaches correct MCP tool usage patterns and parameter formats\n\n### 3. **n8n Workflow Patterns**\nBuild workflows using 5 proven architectural patterns.\n\n**Activates when**: Creating workflows, connecting nodes, designing automation.\n\n**Key Features**:\n- 5 proven patterns (webhook processing, HTTP API, database, AI, scheduled)\n- Workflow creation checklist\n- Real examples from 2,653+ n8n templates\n- Connection best practices\n- Pattern selection guide\n\n### 4. **n8n Validation Expert**\nInterpret validation errors and guide fixing.\n\n**Activates when**: Validation fails, debugging workflow errors, handling false positives.\n\n**Key Features**:\n- Validation loop workflow\n- Real error catalog\n- Auto-sanitization behavior explained\n- False positives guide\n- Profile selection for different stages\n\n### 5. **n8n Node Configuration**\nOperation-aware node configuration guidance.\n\n**Activates when**: Configuring nodes, understanding property dependencies, setting up AI workflows.\n\n**Key Features**:\n- Property dependency rules (e.g., sendBody → contentType)\n- Operation-specific requirements\n- AI connection types (8 types for AI Agent workflows)\n- Common configuration patterns\n\n### 6. **n8n Code JavaScript**\nWrite effective JavaScript code in n8n Code nodes.\n\n**Activates when**: Writing JavaScript in Code nodes, troubleshooting Code node errors, making HTTP requests with $helpers, working with dates.\n\n**Key Features**:\n- Data access patterns ($input.all(), $input.first(), $input.item)\n- **Critical gotcha**: Webhook data under `$json.body`\n- Correct return format: `[{json: {...}}]`\n- Built-in functions ($helpers.httpRequest(), DateTime, $jmespath())\n- Top 5 error patterns with solutions (covering 62%+ of failures)\n- 10 production-tested patterns\n\n### 7. **n8n Code Python**\nWrite Python code in n8n Code nodes with proper limitations awareness.\n\n**Activates when**: Writing Python in Code nodes, need to know Python limitations, working with standard library.\n\n**Key Features**:\n- **Important**: Use JavaScript for 95% of use cases\n- Python data access (_input, _json, _node)\n- **Critical limitation**: No external libraries (requests, pandas, numpy)\n- Standard library reference (json, datetime, re, etc.)\n- Workarounds for missing libraries\n- Common Python patterns for n8n\n\n---\n\n## 🚀 Installation\n\n### Prerequisites\n\n1. **n8n-mcp MCP server** installed and configured ([Installation Guide](https:\u002F\u002Fgithub.com\u002Fczlonkowski\u002Fn8n-mcp))\n2. **Claude Code**, Claude.ai, or Claude API access\n3. `.mcp.json` configured with n8n-mcp server\n\n### Claude Code\n\n**Method 1: Plugin Installation** (Recommended)\n```bash\n# Install directly as a Claude Code plugin\n\u002Fplugin install czlonkowski\u002Fn8n-skills\n```\n\n**Method 2: Via Marketplace**\n```bash\n# Add as marketplace, then browse and install\n\u002Fplugin marketplace add czlonkowski\u002Fn8n-skills\n\n# Then browse available plugins\n\u002Fplugin install\n# Select \"n8n-mcp-skills\" from the list\n```\n\n**Method 3: Manual Installation**\n```bash\n# 1. Clone this repository\ngit clone https:\u002F\u002Fgithub.com\u002Fczlonkowski\u002Fn8n-skills.git\n\n# 2. Copy skills to your Claude Code skills directory\ncp -r n8n-skills\u002Fskills\u002F* ~\u002F.claude\u002Fskills\u002F\n\n# 3. Reload Claude Code\n# Skills will activate automatically\n```\n\n### Claude.ai\n\n1. Download individual skill folders from `skills\u002F`\n2. Zip each skill folder\n3. Upload via Settings → Capabilities → Skills\n\n### API \u002F SDK\n\nSee [docs\u002FINSTALLATION.md](docs\u002FINSTALLATION.md) for detailed instructions.\n\n---\n\n## 💡 Usage\n\nSkills activate **automatically** when relevant queries are detected:\n\n```\n\"How do I write n8n expressions?\"\n→ Activates: n8n Expression Syntax\n\n\"Find me a Slack node\"\n→ Activates: n8n MCP Tools Expert\n\n\"Build a webhook workflow\"\n→ Activates: n8n Workflow Patterns\n\n\"Why is validation failing?\"\n→ Activates: n8n Validation Expert\n\n\"How do I configure the HTTP Request node?\"\n→ Activates: n8n Node Configuration\n\n\"How do I access webhook data in a Code node?\"\n→ Activates: n8n Code JavaScript\n\n\"Can I use pandas in Python Code node?\"\n→ Activates: n8n Code Python\n```\n\n### Skills Work Together\n\nWhen you ask: **\"Build and validate a webhook to Slack workflow\"**\n\n1. **n8n Workflow Patterns** identifies webhook processing pattern\n2. **n8n MCP Tools Expert** searches for webhook and Slack nodes\n3. **n8n Node Configuration** guides node setup\n4. **n8n Code JavaScript** helps process webhook data with proper .body access\n5. **n8n Expression Syntax** helps with data mapping in other nodes\n6. **n8n Validation Expert** validates the final workflow\n\nAll skills compose seamlessly!\n\n---\n\n## 📖 Documentation\n\n- [Installation Guide](docs\u002FINSTALLATION.md) - Detailed installation for all platforms\n- [Usage Guide](docs\u002FUSAGE.md) - How to use skills effectively\n- [Development Guide](docs\u002FDEVELOPMENT.md) - Contributing and testing\n- [MCP Testing Log](docs\u002FMCP_TESTING_LOG.md) - Real tool responses used in skills\n\n---\n\n\n## 🧪 Testing\n\nEach skill includes 3+ evaluations for quality assurance:\n\n```bash\n# Run evaluations (if testing framework available)\nnpm test\n\n# Or manually test with Claude\nclaude-code --skill n8n-expression-syntax \"Test webhook data access\"\n```\n\n---\n\n## 🤝 Contributing\n\nContributions welcome! Please see [DEVELOPMENT.md](docs\u002FDEVELOPMENT.md) for guidelines.\n\n### Development Approach\n\n1. **Evaluation-First**: Write test scenarios before implementation\n2. **MCP-Informed**: Test tools, document real responses\n3. **Iterative**: Test against evaluations, iterate until 100% pass\n4. **Concise**: Keep SKILL.md under 500 lines\n5. **Real Examples**: All examples from real templates\u002Ftools\n\n---\n\n## 📝 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Credits\n\n**Conceived by Romuald Członkowski**\n- Website: [www.aiadvisors.pl\u002Fen](https:\u002F\u002Fwww.aiadvisors.pl\u002Fen)\n- Part of the [n8n-mcp project](https:\u002F\u002Fgithub.com\u002Fczlonkowski\u002Fn8n-mcp)\n\n---\n\n## 🔗 Related Projects\n\n- [n8n-mcp](https:\u002F\u002Fgithub.com\u002Fczlonkowski\u002Fn8n-mcp) - MCP server for n8n\n- [n8n](https:\u002F\u002Fn8n.io\u002F) - Workflow automation platform\n\n---\n\n## 📊 What's Included\n\n- **7** complementary skills that work together\n- **525+** n8n nodes supported\n- **2,653+** workflow templates for examples\n- **10** production-tested Code node patterns\n- **Comprehensive** error catalogs and troubleshooting guides\n\n---\n\n**Ready to build flawless n8n workflows? Get started now!** 🚀\n","n8n-skills 是一个专为构建无缺陷 n8n 工作流而设计的 Claude 代码技能集。该项目通过提供7项互补技能，指导用户如何使用 n8n-mcp MCP 服务器创建生产级工作流，解决了常见的配置错误、验证循环以及节点误配等问题。其核心技术特点包括教授正确的 n8n 表达式语法、高效利用 MCP 工具、采用经验证的工作流模式等。适用于希望提升自动化流程开发效率和质量的开发者或团队，在需要快速准确地构建复杂业务逻辑自动化的场景下尤为有用。",2,"2026-06-11 03:45:24","high_star"]