1. 基本信息
项目自述名称：所在仓库自述为「n8n Skills」（n8n 官方出品的技能合集插件，插件 ID
n8n-skills）；本技能自身文档标题为「n8n Credentials and Security」。
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | n8n-credentials-and-security-official-n8n-io-skills | — |
| 作者/维护者 | n8n 团队（官方组织 n8n-io，插件 manifest 标注 author: n8n，主页 n8n.io） | GitHub API + 仓库 .claude-plugin/plugin.json |
| 来源链接 | https://github.com/n8n-io/skills/tree/main/skills/n8n-credentials-and-security-official | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars（仓库整体） | 372 | GitHub API |
| 该子技能单独统计 | GitHub 不提供子目录级 star 数；改用该子技能相关的 Issue/PR 记录作为热度证据（见第 6、8 章） | 说明性备注 |
| Forks | 39 | GitHub API |
| 最新版本 | 插件 v1.1.0 | 仓库 .claude-plugin/plugin.json |
| 安装方式 | Claude Code / Codex 插件市场一条命令；其他平台可用 skills.sh 或手动复制 SKILL.md | 官方 README |
2. 功能介绍与亮点
核心能力：教 Claude Code / Codex 等编程 Agent 在搭建 n8n workflow 时正确处理认证信息——API Key、Bearer Token、OAuth、Basic Auth 等一切密钥类数据。核心三条硬性规则：密钥一律通过 n8n 凭据系统传递、不得写进文本字段或 SDK 代码；配置任何需要认证的节点前先 list_credentials 按类型查找已有凭据、按 ID 绑定；凭据的创建是用户在 UI 里完成的事，Agent 不得尝试代为创建或在对话中临时接收密钥“以后再配置”。技能内附一张“该用什么认证方式”的决策树（原生凭据优先 → 标准 REST 认证走 HTTP Request 内置认证类型 → 多请求头/请求头+查询参数场景走自定义凭据类型），以及一份反模式对照表，逐条列出“密钥硬编码进 Header 字段”“存进变量再读取”“用 $vars/$env 读密钥”等常见错误对应的真实后果与正确写法。
亮点：
- 专门处理“用户在聊天里直接粘贴密钥”这一高频真实场景——不只是禁止把它写进文本字段，还明确要求告知用户“这个密钥已经暴露给了 LLM 服务商、可能留存在对话记录和缓存里，视为已泄露，请尽快轮换”，态度不含糊；
- n8n 官方团队亲自打造并维护（README 明示“Built by the n8n team”），而非社区逆向工程；
- 仓库记录显示，独立第三方开发者曾直接向本技能文件提交并合并过改进（详见第 6、8 章），证明真实外部使用与打磨；
- 与同仓库其余 12 个专项技能共享一套 hook 驱动的自动路由机制，在涉及认证的节点配置动作前自动提醒查阅本技能。
3. 适用场景
固定分类：集成与工作流自动化
- 用 Claude Code / Codex 通过 n8n MCP 连接 Slack、Gmail、数据库、第三方 REST API 等服务搭建自动化 workflow、且这些服务大多需要 API Key 或 OAuth 认证的开发者；
- 团队协作场景下，需要避免不同人/不同 Agent 各自把密钥硬编码进 workflow JSON、造成密钥随导出/截图泄露的风险；
- 用户习惯把密钥直接粘贴在对话框里让 Agent“顺手配置”的场景，需要 Agent 主动纠正为安全做法而非照单全收。
受益人群：已经或计划把 n8n 作为业务自动化中枢、经手第三方 API 密钥且对凭据安全有基本合规要求的初中级开发者与团队。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方
/plugin marketplace add n8n-io/skills+/plugin install n8n-skills@n8n-io一键安装，README 逐步给出命令。 - Codex：✅ 原生支持——官方文档给出对应的
codex plugin marketplace add/codex plugin add命令（需 Codex ≥ 0.142.0）；但仓库 Issue #40（2026-07-23，独立用户 weijunswj 报告）指出 Codex Desktop 在 Windows 上无法可靠执行插件自带的 shell hooks，截至 2026-07-27 仍处 open 状态——这只影响 hook 自动路由的便利层，不影响手动加载技能正文。 - OpenClaw：❓ 未验证——README 仅笼统提及“其他平台”可尝试 skills.sh（
npx skills add n8n-io/skills），未点名验证 OpenClaw。 - Hermes Agent：❓ 本技能未逐一验证，但有真实相关背景值得说明：仓库 Issue #29（2026-07-04，独立用户 kristianism）记录了同一插件包内另一姊妹技能
n8n-debugging被 Hermes 内置安全扫描器标记为 dangerous 并拦截安装（原因是该技能的排障指引中有一步会把 issue 编号写入 workflow 文件，被判定为“持久化”风险）。本技能内容经查未见同类持久化指引，但由于全部技能作为同一插件一次性安装，未来若使用 Hermes 应留意该姊妹技能的安全扫描结果。
5. 推荐理由
n8n 官方团队亲自出品，直接命中一个真实高频的风险点：Agent 辅助搭建 workflow 时最容易犯的错误之一就是图省事把密钥写进文本字段或变量，这份技能把“该怎么做”钉成三条硬性规则+一张决策树+一份反模式表，而不是泛泛提醒“注意安全”。对用户主动把密钥粘贴进对话框这类真实场景也给出了具体应对话术（提醒轮换），体现出对实际使用情形的打磨，而非纸面规范。仓库记录显示已有独立第三方开发者直接为本技能贡献过改进并被合并，说明它在真实使用中被检验过。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | n8n 为知名工作流自动化厂商、官方团队亲自出品，仓库整体 372 stars（合集仓库数字，不代表本技能个体热度，见第 1 章说明）；GitHub 不提供子目录级 star 数，改查该文件的 Issue/PR 记录佐证——独立第三方开发者 kristianism（GitHub 资料显示为金融系统开发者，无 n8n 雇佣关系）提交的 PR #31 直接修改过本技能 SKILL.md 正文并已合并，是本技能自身层面（非仅仓库层面）的真实外部参与证据 |
| 可用性 | 9 | Claude Code 官方插件市场一条命令安装，Codex 有对应命令，两大主流平台均一键接入；技能正文附决策树、反模式对照表与“用户粘贴密钥怎么办”的具体步骤，可直接照做；同插件内 SessionStart/PreToolUse hook 会在配置认证类节点前自动提醒核验本技能，降低“Agent 忘记查资料”的常见失败模式；依赖预先开启 MCP server 的 n8n 实例作为前置条件，非纯开箱即用 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令权限范围 | 本技能自身不含可执行脚本，仅指导 Agent 调用用户已授权的 n8n MCP 工具（list_credentials、setNodeCredential 等），未见越权行为，未扣分 |
| ② 运行时联网外发 | 未发现本技能有独立于用户自有 n8n 实例之外的外发行为 |
| ③ API key/凭据存储 | 这正是本技能的核心内容——明文禁止把密钥写进文本字段、变量或 SDK 代码，强制走加密存储的凭据系统，且对“用户已经泄露密钥”的场景给出明确的轮换提醒，属于安全实践的正面示范 |
| ④ 可疑指令/注入迹象 | 本技能文本未见可疑指令。但同一插件包内的姊妹技能 n8n-debugging 曾于 2026-07-04 被独立用户举报存在“持久化 issue 编号到 workflow 文件”的问题，并被 Hermes Agent 安全扫描器标记为 dangerous（详见第 4 章），截至 2026-07-27 仍处 open 状态尚未修复——与本技能内容无直接关系，但因随同一插件整体安装，计入扣分 |
| ⑤ 作者/组织信誉 | n8n 为知名工作流自动化厂商，官方组织 n8n-io，插件 manifest（author: n8n，homepage: n8n.io）可核验，未扣分 |
| ⑥ License 明确性 | Apache-2.0，明确，未扣分 |
| ⑦ 最近维护时间 | 仓库 2026-04-20 创建，最近提交 2026-07-26，持续更新，非弃置项目，未扣分 |
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 官方程度 / 热度证据 | 与本技能的差异 |
|---|---|---|---|
| n8n-credentials-and-security-official（本技能，n8n 官方） | 凭据/密钥认证专项安全指南 | 官方仓库，本文件有独立开发者直接贡献并合并的 PR 记录 | 专项深度：三条硬性规则 + 决策树 + 反模式表，覆盖“用户粘贴密钥”等具体场景 |
| n8n-workflow-lifecycle-official（同仓库姊妹技能） | n8n workflow 全生命周期方法论（计划→构建→校验→测试→发布→交接） | 官方仓库，同仓库同等热度证据 | 广度优先：凭据安全只是其六阶段流程中的一条 non-negotiable，未展开决策树或反模式细节 |
| czlonkowski/n8n-skills（社区版技能合集） | 覆盖 n8n Agent、代码节点、表达式、自托管等 15 个技能 | 社区维护，仓库 5,881 stars，规模远超官方仓库 | 技能清单中没有专门的凭据/安全技能，认证相关内容分散在节点配置等技能中，未形成独立成体系的安全规范 |
| 通用密钥管理方案（如 HashiCorp Vault、1Password Connect 等） | 面向任意应用的企业级密钥托管与轮换基础设施 | 成熟商业/开源产品 | 定位完全不同：提供的是密钥托管基础设施本身，需要额外部署与集成成本，不像本技能直接教 Agent 在 n8n 里“当下该怎么做”，二者可以互补而非替代 |
核心差异化：本技能不是泛泛的“注意安全”提醒，而是把 n8n 场景下最容易出错的凭据处理动作拆解成可直接执行的规则、决策树与真实场景应对话术，专项深度明显超过覆盖全生命周期的姊妹技能，也补上了热度更高的社区版技能包里的一处空白。
8. 用户评价
该技能目前在第三方平台尚无独立评价文章。可查的具名证据来自 GitHub：独立开发者 kristianism（GitHub 资料显示为金融系统开发者，构建链上/链下金融基础设施，含 n8n 自动化项目，与 n8n 官方无雇佣关系）于 2026-07-06 提交 Pull Request #31（https://github.com/n8n-io/skills/pull/31），直接为本技能 SKILL.md 正文补充了 explore_node_resources 工具的使用指引，已被仓库维护者合并。同一开发者此前还在同仓库提交过 Issue #29，反映的是另一姊妹技能的安全扫描问题（见第 4、6 章），侧面印证该开发者对整个技能包有过持续的实际使用与检验，但该 issue 本身与本技能内容无关。
9. 其他补充
同仓库另有 12 个专项技能（工作流生命周期、循环分页、错误处理、AI Agent 节点配置、二进制数据处理等）与 1 个路由入口技能 using-n8n-skills-official，随插件一次性安装、共享同一套 hook 自动路由机制。仓库明确欢迎社区为其他编程 Agent（Cursor、OpenCode 等）贡献适配插件。
10. 安装使用方式
Claude Code（官方推荐）：
/plugin marketplace add n8n-io/skills
/plugin install n8n-skills@n8n-io安装时会提示填写 n8n 实例 URL，随后运行 /reload-plugins 生效。
Codex：
codex plugin marketplace add n8n-io/skills
codex plugin add n8n-skills@n8n-io重启后首次运行会提示信任插件 hooks，需批准以启用自动路由提醒；另需手动添加 MCP 服务器：
codex mcp add n8n-mcp --url https://<你的n8n域名>/mcp-server/http其他平台（OpenClaw / Hermes 等，非官方支持）：
npx skills add n8n-io/skills需自行在 AGENTS.md 中补充片段，引导 Agent 每次涉及认证/密钥的 n8n 任务时主动加载本技能——通用安装方式没有 hook 自动触发，退化为纯文档。
前置条件：需要一个已开启实例级 MCP server 的 n8n 实例（Cloud 或自托管均可，最低 n8n 2.2.0），在 n8n 的 Settings → Instance-level MCP 中启用。
11. 注意事项
- 需要预先具备已开启 MCP server 的 n8n 实例，单纯装技能无法替代该前置配置；
- 同插件包内的姊妹技能
n8n-debugging存在尚未修复的安全披露（Issue #29，被 Hermes Agent 安全扫描器标记为 dangerous），若计划在 Hermes 环境使用同一插件包，建议关注该 issue 的后续修复进展； - Codex Desktop 在 Windows 上执行插件自带 shell hooks 存在已知不稳定问题（Issue #40，截至 2026-07-27 仍 open），会影响自动路由提醒的可靠性，但不影响手动查阅技能正文；
- Hook 自动路由能力目前限 Claude Code / Codex 插件系统，OpenClaw / Hermes 等平台需手动配置
AGENTS.md片段才能获得同等的“自动提醒”体验； - 插件版本仍处 v1.1.0，仓库创建于 2026-04-20，历史积累约 3 个月，长期可持续性有待观察。