Agent Skills
› czlonkowski/n8n-skills
czlonkowski/n8n-skills
GitHubn8n验证专家，指导解读和修复工作流验证错误。适用于处理validate_node调用返回的错误、警告及误报，识别需修复的真错误与建议项，帮助用户理解验证结果并迭代修正配置。
Install All Skills
npx skills add czlonkowski/n8n-skills --all -g -y
Skills in Collection (15)
n8n验证专家，指导解读和修复工作流验证错误。适用于处理validate_node调用返回的错误、警告及误报，识别需修复的真错误与建议项，帮助用户理解验证结果并迭代修正配置。
遇到 n8n 验证错误或警告
需要理解 validate_node 或 validate_workflow 的返回结果
询问验证配置文件或自动修复能力
npx skills add czlonkowski/n8n-skills --skill n8n-validation-expert -g -y
指导在n8n中正确设计AI Agent及相关LangChain节点，涵盖模型选择、工具调用、记忆管理、结构化输出及RAG等核心概念。
构建或编辑n8n AI Agent节点
需要实现多轮对话或工具调用逻辑
涉及LLM与工具的集成配置
使用结构化输出或输出解析器
npx skills add czlonkowski/n8n-skills --skill n8n-agents -g -y
解决n8n中二进制数据与JSON分离导致的文件丢失、AI工具调用失败及聊天界面渲染问题，涵盖读写、保持及CDN URL规范。
处理文件、图片、PDF或附件上传下载
提及$binary、base64或vision输入
AI代理需要文件作为工具输入输出
Merge节点导致二进制数据丢失
npx skills add czlonkowski/n8n-skills --skill n8n-binary-and-data -g -y
提供n8n中JavaScript代码节点的编写、审查与调试指南，明确何时使用代码节点及原生节点替代方案，涵盖数据访问、运行模式、内置函数及性能优化等核心实践。
在n8n工作流中编写或修改JavaScript代码节点
排查n8n代码节点报错或逻辑错误
评估是否应使用代码节点而非原生节点
npx skills add czlonkowski/n8n-skills --skill n8n-code-javascript -g -y
指导在 n8n Code 节点中使用原生 Python，涵盖 _items/_item 变量操作、模式配置及常见错误排查。
用户明确要求在 n8n Code 节点使用 Python
迁移旧版 Pyodide 代码或解决 NameError、安全违规等运行时错误
npx skills add czlonkowski/n8n-skills --skill n8n-code-python -g -y
提供n8n Custom Code Tool开发指南，指导编写供AI Agent调用的JS/Python代码。明确区分其与Code节点的差异，规范输入输出格式、变量名及Schema配置，解决常见报错。
编写n8n AI Agent可调用的Custom Code Tool
调试Code Tool返回类型或输入解析错误
区分Code节点与Code Tool的运行环境差异
npx skills add czlonkowski/n8n-skills --skill n8n-code-tool -g -y
规范n8n工作流错误处理，确保失败可观测、结构化且可恢复。涵盖节点级错误输出配置、重试机制及全局错误工作流，防止静默失败，适用于Webhook、定时任务等关键路径。
构建Webhook或API工作流
设置定时或无人值守任务
解决工作流静默失败问题
配置onError、重试或错误分支
npx skills add czlonkowski/n8n-skills --skill n8n-error-handling -g -y
提供 n8n 表达式语法规范与错误修复指南，涵盖核心变量使用、节点数据引用及 Webhook 数据结构处理。
编写或调试 n8n 工作流表达式
排查节点间数据传递错误
配置涉及动态数据的节点字段
npx skills add czlonkowski/n8n-skills --skill n8n-expression-syntax -g -y
n8n MCP工具专家技能，指导用户高效使用n8n相关MCP工具。涵盖节点搜索、配置验证、工作流管理、凭据管理、安全审计及Agent管理等场景，提供选型指南、参数格式和最佳实践，防止常见错误。
用户提及n8n、工作流或自动化需求
需要调用任何n8n-mcp工具进行节点查找或配置
npx skills add czlonkowski/n8n-skills --skill n8n-mcp-tools-expert -g -y
指导在多实例 n8n 环境下通过 MCP 连接操作多个实例。核心规则包括：调用时显式指定 instance 参数或全局切换默认值；强调凭证写入前必须明确目标实例以防误操作；遇到 NOT_FOUND 或 INSTANCE_AMBIGUOUS 错误时需检查实例路由而非假设数据删除。
用户涉及多个 n8n 实例或环境（如 prod/staging）的操作
工具返回 INSTANCE_AMBIGUOUS 或 INSTANCE_NOT_FOUND 错误
执行凭证创建、更新或删除等高敏感操作
工作流或数据表调用返回意外 NOT_FOUND 或数据不匹配
npx skills add czlonkowski/n8n-skills --skill n8n-multi-instance -g -y
提供n8n工作流节点配置指导，基于操作类型确定必填字段，解释属性依赖关系及displayOptions控制逻辑。推荐使用标准详情层级进行渐进式发现与验证，涵盖原生节点及代码替换节点的参数设置最佳实践。
配置n8n节点参数
查询节点必填字段
理解节点属性依赖
npx skills add czlonkowski/n8n-skills --skill n8n-node-configuration -g -y
指导在Linux VM上通过SSH使用Docker Compose和Caddy反向代理，部署生产级自托管n8n实例。涵盖单节点与队列模式选择、HTTPS自动配置、密钥管理及备份恢复，适用于Hetzner等云服务器或裸金属环境。
部署 n8n
自托管 n8n
n8n docker compose
n8n queue mode / workers
n8n reverse proxy / SSL
back up / update my n8n
npx skills add czlonkowski/n8n-skills --skill n8n-self-hosting -g -y
指导在n8n中构建可复用子工作流，涵盖输入输出契约设计、执行模式选择及命名发现规范，旨在解决逻辑复用和模块化问题。
需要提取共享或重复使用的逻辑
工作流节点超过10个需模块化
提及Execute Workflow或子工作流相关概念
npx skills add czlonkowski/n8n-skills --skill n8n-subworkflows -g -y
提供n8n工作流的核心架构模式，涵盖Webhook、API集成、数据库操作、AI代理、定时任务及批处理。用于指导新工作流的设计、构建、优化及性能提升，确保最佳实践。
创建或设计n8n工作流
优化缓慢的工作流
选择工作流架构模式
连接外部服务实现自动化
npx skills add czlonkowski/n8n-skills --skill n8n-workflow-patterns -g -y
n8n工作流构建与调试的路由技能，指导用户调用专业工具，强调先验证后激活及凭据安全规则。
构建或编辑n8n工作流
调试节点或表达式错误
配置工作流连接
npx skills add czlonkowski/n8n-skills --skill using-n8n-mcp-skills -g -y
