Agent Skills
› n8n-io/n8n
n8n-io/n8n
GitHub用于Agent Builder界面设计与审查的Skill，涵盖配置模式、弹窗流程及响应式行为。仅限修改agents功能模块代码，需遵循设计语言规范并同步更新文档与测试。
安装全部 Skills
npx skills add n8n-io/n8n --all -g -y
集合内 Skills (46)
用于Agent Builder界面设计与审查的Skill，涵盖配置模式、弹窗流程及响应式行为。仅限修改agents功能模块代码，需遵循设计语言规范并同步更新文档与测试。
Agent界面UI开发
Agent组件重构
Agent交互逻辑调整
npx skills add n8n-io/n8n --skill n8n:agent-design-language -g -y
自动检查社区PR是否具备人工审查条件，验证CLA、格式及测试覆盖等。根据结果执行标签管理、Linear工单路由或评论反馈，实现自动化分流与预处理。
提供PR编号或分支名时
用户输入/community-pr-readiness-check命令
询问PR是否准备好进行人工审查
npx skills add n8n-io/n8n --skill n8n:community-pr-readiness-check -g -y
专注SaaS产品的UI文案设计，支持撰写、审查和审计按钮、错误提示等用户界面文本。遵循简洁中立原则，提供i18n键值建议及多选项推荐，确保术语一致性与用户体验。
需要撰写或优化UI界面文案
审查现有产品文本的合规性
审计i18n文件或Vue组件中的文案问题
用户输入/copy, /content, /ux-copy
npx skills add n8n-io/n8n --skill n8n:content-design -g -y
n8n开发规范速查，涵盖TS类型、前后端架构、测试及命令等关键模式与规则。
需要快速回顾n8n代码规范
查询前端或后端最佳实践
npx skills add n8n-io/n8n --skill n8n:conventions -g -y
用于编写和校准 n8n Agent Builder 的 AI 评估用例。通过 LangTracer 验证 Agent 构建路由、配置及响应，确保行为符合预期。
需要为 Agent Builder 功能创建或更新测试用例
验证 Agent 构建流程的正确性与鲁棒性
npx skills add n8n-io/n8n --skill n8n:create-agent-builder-eval -g -y
指导为n8n社区节点插件创建新的ESLint规则，涵盖规则设计、实现、测试及注册流程。
添加新的ESLint规则
修复或增强代码检查逻辑
维护eslint-plugin-community-nodes包
npx skills add n8n-io/n8n --skill n8n:create-community-node-lint-rule -g -y
用于创建和校准 Instance AI 评估用例，指导编写 JSON 格式的工作流或 Agent 测试案例，并与 LangTracer CI 集成。
需要新增 Instance AI 评估用例
调试不稳定的评估用例
校准评估案例以匹配实际构建
npx skills add n8n-io/n8n --skill n8n:create-instance-ai-eval -g -y
根据用户指令在 Linear 或 GitHub 创建 Issue，支持 Bug、功能等技术债务模板，强制使用简化技术英语规范标题和描述。
用户要求创建工单
提交 Bug 报告
打开 Issue
输入 /create-issue
npx skills add n8n-io/n8n --skill n8n:create-issue -g -y
用于创建符合n8n规范的GitHub PR，自动校验标题格式、分析变更内容并生成描述。
用户要求创建PR
输入/pr指令
npx skills add n8n-io/n8n --skill n8n:create-pr -g -y
指导用户创建有效的 Agent Skills，涵盖技能结构、最佳实践及 SKILL.md 格式规范。
创建新 skill
编写 skill 文档
询问 skill 结构或格式
npx skills add n8n-io/n8n --skill n8n:create-skill -g -y
指导编写 n8n 数据库迁移文件，涵盖 Schema 与数据迁移规范、跨库兼容性及 DSL 使用。适用于创建/修改迁移代码、添加字段索引或执行数据回填等场景。
创建或修改 packages/@n8n/db/src/migrations/ 下的文件
用户请求添加列、表、索引、外键或进行数据回填
提及 DB migrations 或 TypeORM migrations
npx skills add n8n-io/n8n --skill n8n:db-migrations -g -y
提供前端设计系统的开发规范，指导Vue组件构建、样式管理及UI变更审查。涵盖CSS变量使用、现有组件优先原则、暗黑模式适配及Storybook故事编写标准，确保界面一致性与可维护性。
修改 .vue/.css/.scss 文件
新增或重构 UI 组件
审查界面变更
实现深色模式适配
npx skills add n8n-io/n8n --skill n8n:design-system -g -y
负责为@Env配置属性编写和审查JSDoc，确保符合n8n文档风格指南。面向自托管操作员，提供清晰的环境变量说明，排除内部实现细节和攻击场景，规范单位、格式及用语，保障公开文档的准确性和可读性。
添加或修改@Env属性时
审查涉及配置类的PR时
npx skills add n8n-io/n8n --skill n8n:env-var-docs -g -y
指导 editor-ui 前端实验代码的生命周期管理，涵盖创建、扩展、集成、测试、审查及废弃实验相关功能。
创建或扩展前端实验功能
进行实验代码的集成、测试或审查
npx skills add n8n-io/n8n --skill n8n:experiments -g -y
管理基于GitHub CLI的堆叠分支与PR工作流，支持创建、推送、变基、同步及导航依赖分支链，适用于增量代码审查场景。
需要创建或管理堆叠分支
处理依赖关系的PR链
进行增量代码审查流程
npx skills add n8n-io/n8n --skill n8n:gh-stack -g -y
基于 GitHub PR URL，结合上下文与 Linear 工单，执行深度代码审查并输出 Markdown 报告。关注架构、Bug、安全及测试覆盖，不修改代码。
收到 GitHub Pull Request 链接
用户输入 /human-like-code-review
npx skills add n8n-io/n8n --skill n8n:human-like-code-review -g -y
获取并分析 Linear 工单及其关联上下文（评论、依赖、附件）。用于开始处理工单前收集完整信息，强制检查私有标签合规性，支持自动拉取图片及关联 GitHub PR。
开始处理 Linear 工单
需要分析工单背景与上下文
收集工单相关代码和讨论记录
npx skills add n8n-io/n8n --skill n8n:linear-issue -g -y
从Loom视频链接提取并展示完整字幕或转录文本，通过解析URL获取ID，调用GraphQL API下载VTT或JSON格式内容并格式化输出。
用户请求获取Loom视频的转录内容
用户希望阅读或查看Loom视频的文字记录
npx skills add n8n-io/n8n --skill n8n:loom-transcript -g -y
通过内部Nathan机器人部署n8n临时测试实例，支持PR后自动推荐配置并生成Docker命令，用于UI、功能变更的可视化验证。
用户请求启动测试环境
打开包含UI或功能变更的PR时
npx skills add n8n-io/n8n --skill n8n:nathan -g -y
为n8n现有节点添加OAuth2认证支持，包括生成凭证文件、更新节点代码及测试。
/node-add-oauth
npx skills add n8n-io/n8n --skill n8n:node-add-oauth -g -y
定义n8n REST端点RBAC权限装饰器使用规范，指导为路由添加ProjectScope或GlobalScope以防范越权漏洞。
创建新的RestController
为现有控制器添加路由
审查端点授权配置
npx skills add n8n-io/n8n --skill n8n:protect-endpoints -g -y
规范 n8n Public API v1 端点的开发、迁移与更新，涵盖控制器创建、DTO定义、RBAC权限、游标分页及测试集成。明确非协商规则与团队默认约定，确保公共接口稳定性与安全。
需要添加或更新 n8n Public API v1 端点
涉及 /api/v1 路径的接口暴露或服务迁移
编写符合 Public API 规范的控制器和 DTO
npx skills add n8n-io/n8n --skill n8n:public-api -g -y
基于 Linear 工单上下文，系统性复现 Bug 并编写失败回归测试。通过解析错误信号、路由测试策略、定位源码、追踪代码路径及假设验证，最终生成针对特定问题的单元测试或集成测试。
收到包含标题、描述和评论的完整 Linear 工单上下文
需要为已知 Bug 创建失败的回归测试以复现问题
npx skills add n8n-io/n8n --skill n8n:reproduce-bug -g -y
规范驱动开发技能，确保代码实现与 .agents/specs/ 中的规格说明保持同步。适用于新功能实现、规格验证及更新，通过对比检查 API、配置和结构一致性，消除漂移并标记差距。
开始实现文档化的功能
用户请求 /spec 命令
验证实现是否符合规格说明
根据变更更新规格说明
npx skills add n8n-io/n8n --skill n8n:spec-driven-development -g -y
指导n8n系统中遥测事件的注册、添加与审查，提供事件目录查询、命名规范及Zod类型定义指南。
添加或修改遥测事件
审查track()调用
查询已注册的事件属性
npx skills add n8n-io/n8n --skill n8n:telemetry -g -y
提供前端UI设计与组件开发指南，涵盖样式规范、设计系统组件使用及动画最佳实践。适用于编辑器界面和设计系统包的代码实现与重构。
前端组件重构
UI样式调整
设计系统功能开发
npx skills add n8n-io/n8n --skill n8n:ui-design -g -y
配置 n8n 开发所需的 MCP 服务器。通过检查现有配置、提供多选菜单并逐个引导用户安装 Linear、Notion、Context7 和 Figma 等集成，简化环境设置流程。
用户请求设置 MCP 服务器
执行 /setup-mcps 命令
npx skills add n8n-io/n8n --skill n8n:setup-mcps -g -y
用于在OpenCode中为n8n开发配置MCP服务器，支持Linear、Notion等集成。
用户说/setup-mcps
要求设置n8n的MCP服务器
npx skills add n8n-io/n8n --skill n8n:setup-mcps -g -y
通过CLI管理n8n实例，支持工作流、凭证和执行的CRUD操作及状态控制。适用于自动化集成、批量管理及从命令行直接操作n8n平台。
需要自动化或批量管理n8n工作流
通过命令行查看或重试执行记录
配置或更新n8n凭证信息
npx skills add n8n-io/n8n --skill n8n-cli -g -y
指导用户通过 agent_builder_* 工具创建、配置、测试和发布 n8n Agent，涵盖路由选择、目标定位及构建流程。
需要创建新的 Agent
修改现有 Agent 的配置或能力
npx skills add n8n-io/n8n --skill agent-builder -g -y
用于通过eval-config工具配置基于配置的AI工作流评估，包括设置评估名称、起止节点、数据集及LLM评判指标。
用户要求设置或修改工作流评估
需要衡量AI输出质量或评分
npx skills add n8n-io/n8n --skill config-evals -g -y
根据服务文档自动查找并验证认证方案、密钥页面URL及测试端点，确保凭证配置准确无误。
需要为无专用凭证类型的服务生成凭证提示
修复错误的模板、密钥页或测试端点
npx skills add n8n-io/n8n --skill credential-recipe-research -g -y
指导使用 Computer Use 浏览器工具自动化配置 n8n 凭证。涵盖连接外部控制台、安全捕获密钥及创建凭证，避免人工输入敏感信息。
需要配置 OAuth 或 API Key
用户请求设置外部服务凭证
npx skills add n8n-io/n8n --skill credential-setup-with-computer-use -g -y
用于调试工作流执行失败或输出异常的技能。通过重新运行和检查节点参数、认证状态等，定位并报告根本原因，避免盲目猜测。
用户报告工作流执行失败
节点输出错误或为空值
出现红色错误表达式
npx skills add n8n-io/n8n --skill debugging-executions -g -y
指导 Agent 通过低成本读取实例状态（如上下文块、活动日志、工作流详情）来理解当前环境，避免重复询问用户。核心原则是‘询问意图，查看状态’，旨在提升对已有构建和运行记录的感知能力。
用户输入简短或模糊指令（如'修复它'）
询问近期运行或失败的状态
引用之前对话中的工作
npx skills add n8n-io/n8n --skill instance-awareness -g -y
基于n8n官方文档解答产品配置、凭证设置、节点使用及故障排除等问题。优先调用工具查询文档，提供准确的配置指南和OAuth权限说明，并引用来源。
用户询问如何配置或设置n8n功能
用户需要解决n8n凭证或节点问题
用户想了解n8n行为或API用法
npx skills add n8n-io/n8n --skill n8n-docs-assistant -g -y
管理计划任务的运行时交互，处理任务创建后的静默、状态轮询禁止及合成跟进。确保在后台任务完成时自动接收通知并生成最终交付摘要，避免冗余输出和手动轮询。
用户请求构建工作流或执行计划任务后
系统返回 <planned-task-follow-up>、<background-task-completed> 或 <running-tasks> 标签时
npx skills add n8n-io/n8n --skill planned-task-runtime -g -y
用于协调多工作流依赖、共享数据表迁移或需先审查计划的复杂编排任务。通过构建依赖感知任务图并调用workflow_builder_create_tasks提交，适用于非单一工作流的协作场景。
多个工作流存在依赖关系
跨任务共享数据表架构或迁移
用户明确要求先审查计划
涉及多持久化工件的协调
npx skills add n8n-io/n8n --skill planning -g -y
处理构建成功后的工作流验证与设置，包括检查配置、模拟执行及触发器测试。
构建成功且需后续验证
收到工作流验证跟进消息
需要工作流设置
npx skills add n8n-io/n8n --skill post-build-flow -g -y
根据用户团队和常用应用，推荐三个最相关的自动化工作流选项供选择。基于上下文或询问获取信息，确认选择后构建具体流程，旨在引导新用户快速上手n8n自动化功能。
用户询问可以自动化的事项
用户希望获得第一个工作流的建议
npx skills add n8n-io/n8n --skill suggest-automations -g -y
管理n8n数据表的创建、查询、导入及维护，提供Schema设计规则与操作规范，支持通过工具调用处理表格相关任务。
用户询问或列出数据表
需要创建或修改数据表结构
从文件导入或清洗数据到表格
npx skills add n8n-io/n8n --skill data-table-manager -g -y
用于在构建自动化前分类请求意图，判断顶层控制流归属（工作流或智能体）及嵌入关系。处理复合请求、中途引入的独立自动化及需澄清的场景，指导后续路由至对应构建器。
需要确定自动化请求意图时
重新考虑当前工件意图时
遇到复合自动化请求
构建中途引入独立自动化
无法直接查询外部系统的一次性报告
需要澄清才能选择锚点
npx skills add n8n-io/n8n --skill intent-recognition -g -y
指导AI工作流中模型的选择、替换与验证，强调保留现有ID，依据凭证或搜索工具推荐新模型，避免默认过时选项。
选择新的AI模型
替换现有工作流中的模型
验证模型可用性
处理模型相关查询
npx skills add n8n-io/n8n --skill model-selection -g -y
处理一次性操作（如数据迁移、清理、导出），通过推断任务形态而非显式标记识别。优先直接执行单节点，避免构建工作流，适用于无复用意图的即时状态变更请求。
用户请求一次性数据导出或复制
涉及数据迁移、回填或清理的一次性任务
build-workflow结果包含postBuildFlow.reason 'direct-one-off-build-succeeded'
npx skills add n8n-io/n8n --skill one-off-operations -g -y
指导渐进式构建工作流，分步添加触发器和服务，确保每步执行成功后再扩展。适用于新建或修复复杂工作流场景。
创建新工作流
扩展现有工作流功能
修复工作流构建问题
npx skills add n8n-io/n8n --skill progressive-building -g -y
n8n工作流构建专家，负责生成和修改TypeScript工作流代码。支持新建、编辑及修复流程，集成凭证设置与数据表管理，确保SDK合规性及错误调试。
创建新的n8n自动化工作流
修改或优化现有工作流节点
修复工作流运行时的报错或配置问题
配置工作流所需的API凭证或服务连接
npx skills add n8n-io/n8n --skill workflow-builder -g -y
