czlonkowski/n8n-skills

n8n skillset for Claude Code to build flawless n8n workflows

What it solves

通过 AI 编程方式构建 n8n 工作流可能因表达式语法复杂、工具使用错误、验证错误循环以及节点配置不当而变得困难。本项目提供一组专门的「技能」，教导 AI 助手（特别是 Claude）如何构建生产就绪的 n8n 工作流，并正确部署自托管实例。

How it works

它由 14 个互补的技能和一个针对 n8n-mcp MCP 服务器设计的执行层组成。这些技能充当专家指南，会根据用户的查询自动激活。它们覆盖 JavaScript/Python 代码节点、AI 代理设计、二进制数据处理和错误恢复等特定领域。通过使用 hook 与 router 技能的「执行层」在工具使用前后主动 nudges AI 朝正确指引方向，以防止常见错误。

Who it’s for

使用 Claude Code、Claude.ai 或 Claude API 的开发者和自动化工程师，想要自动化创建、验证和部署 n8n 工作流的人。

Highlights

  • 14 Specialized Skills：涵盖从表达式语法、节点配置到 AI 代理设计和子工作流的全部内容。
  • Proactive Enforcement：使用 router 技能和前/后工具 hook，确保 AI 在正确的时间使用正确的模式。
  • Code Node Expertise：提供针对 JavaScript 和 Python 的具体指导，包括 webhook 数据访问等关键「陷阱」。
  • Deployment Automation：包含专门的技能，使用 Docker Compose 与 Caddy 部署生产自托管 n8n 实例。
  • Validation Support：包含一项专家技能，用于解释验证错误并打断错误循环。