n8n Sub-workflows 技能
以类型化输入和明确的执行契约提取可复用的 n8n 工作流。
社区 · Romuald Członkowski| 作者 | Romuald Członkowski |
|---|---|
| 许可证 | MIT |
| 来源 | czlonkowski/n8n-skills · GitHub 上的 SKILL.md |
| 项目官网 | docs.n8n.io |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
n8n-subworkflows 技能: 以类型化输入和明确的执行契约提取可复用的 n8n 工作流。
先搜索现有工作流,再定义输入输出契约,并选择批量或逐条调用。
摘自该技能的 SKILL.md: # n8n Sub-workflows
功能
- 先搜索现有工作流,再定义输入输出契约,并选择批量或逐条调用。
产出内容
- 可复用工作流契约、调用方字段映射和独立测试用例。
适用场景
- 把这段重复逻辑提取为类型化的 n8n 子工作流。
不适用的场景
- 把说明文件当成远程服务、验证或部署成功的保证。
所需条件
- 需要兼容的 n8n-mcp 服务器和真实工作流数据。在线管理需要已授权的 n8n 实例;关联服务与托管可能另收费。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 入口说明与任务专用流程。 |
SUBWORKFLOW_PATTERNS.md | 此流程使用的配套参考资料。 |
NAMING_AND_DISCOVERY.md | 此流程使用的配套参考资料。 |
2026-11-17 在仓库中查到的许可证:MIT。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 把这段重复逻辑提取为类型化的 n8n 子工作流。
- 检查此调用方该使用 all 还是 each 模式。
- 围绕共享的规范化核心,分离二进制与 JSON 输入。
如何安装 n8n-subworkflows
准备工作流程
官网链接指向 n8n 产品文档,不是社区 MCP 安装器。n8n-mcp 需另装;托管及关联服务可能收费。安装前请检查插件 hooks。
复制技能文件夹到其他代理不会安装 Claude Code 插件钩子。执行前检查实时工具结构并审核写入操作。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:从插件市场安装
- 在终端中用
claude启动 Claude Code。 - 添加插件市场(每台电脑一次):
/plugin marketplace add czlonkowski/n8n-skills - 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
/plugin install n8n-mcp-skills@n8n-mcp-skills - 输入 / 查找
/n8n-mcp-skills:n8n-subworkflows,或直接提出任务。
也可以不进入会话,直接在 shell 中运行:
claude plugin marketplace add czlonkowski/n8n-skills
claude plugin install n8n-mcp-skills@n8n-mcp-skills插件会整体安装,因此会附带其他技能,包括 n8n-agents, n8n-binary-and-data, n8n-code-javascript, n8n-code-python, n8n-code-tool, n8n-error-handling, n8n-expression-syntax, n8n-mcp-tools-expert, n8n-multi-instance, n8n-node-configuration, n8n-self-hosting, n8n-validation-expert, n8n-workflow-patterns, using-n8n-mcp-skills。
Claude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p ~/.claude/skills
cp -R n8n-skills/skills/n8n-subworkflows ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /n8n-subworkflows,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-subworkflows .agents/skills/| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
可检索的契约
名称应描述用途并以动词开头,记录输入输出结构。先搜索,避免重复已有工作流。
同步迁移调用方
更改输入字段可能让调用方悄然失败。同步更新映射,并检查验证结果和实际输出。
关于 n8n-subworkflows 的常见问题
本网站会执行技能吗?
不会,这是基于源码的安装指南,技能由您配置的代理环境执行。
这里核实了完整云端流程吗?
没有,因此不提供通用云端上传及 API 执行步骤;仍须满足源码的本地依赖与宿主能力。
所有触发器都应该透传输入吗?
不是。优先使用 Define Below 的类型化输入;二进制和确实无输入的工作流是明确例外。
触发后不等待,能证明完成吗?
不能。异步执行需要单独的完成追踪机制,并明确副作用契约。
更多 AI 技能
相关技能
n8n Code Tool 技能
社区 · Romuald Członkowski为代理编写以 query 输入、字符串输出的 n8n Custom Code Tool。n8n Node Configuration 技能
社区 · Romuald Członkowski按实时结构、操作和属性依赖配置 n8n 节点。n8n Validation Expert 技能
社区 · Romuald Członkowski解读 n8n 验证错误、验证配置和运行时核验要求。n8n Error Handling 技能
社区 · Romuald Członkowski为无人值守的 n8n 任务连接错误输出、重试及工作流级告警。n8n Binary and Data 技能
社区 · Romuald Członkowski在 n8n 节点、代理工具和聊天界面之间完整保留文件字节和元数据。Using n8n MCP Skills 技能
社区 · Romuald Członkowski配置或修改 n8n 工作流前,将任务分派到对应专业技能。