1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | infisical-setup-infisical-ai-skills |
| 项目自述名称 | README 中称 infisical-setup；SKILL.md 内部 name 字段为 infisical-user-setup-guide |
| 作者/维护者 | Infisical Inc.（开源密钥管理平台官方团队） |
| 来源链接 | https://github.com/infisical/ai-skills/tree/main/skills/infisical-setup |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars | 25（数据来自 GitHub API，为该技能集合所在配套仓库的整体数字，非单个技能独立数字） |
| Forks | 1（GitHub API） |
| 最新版本 | 仓库未使用 Release/Tag 做版本管理，最近一次提交时间为 2026-04-19 |
| 安装方式 | Claude Code 插件市场 / npx skills add / 手动复制到 .claude/skills/ |
2. 功能介绍与亮点
infisical-setup 是 Infisical 官方发布的“项目接入引导”技能，帮助用户把开源密钥管理平台接入本地开发（CLI）、Docker（构建期/运行期注入）、Kubernetes（Operator + CRD）、CI/CD（GitHub Actions、GitLab CI）及应用代码（Node.js、Python、Go、Java、.NET、Ruby SDK），并按平台推荐合适的机器身份认证方式（如 AWS 上用 AWS Auth、K8s 上用 Kubernetes Auth、GitHub Actions 上用 OIDC）。
亮点是自带可复现的效果验证数据：仓库 evals/ 目录公开了 A/B 测试——同一提示词分别在“加载技能”与“不加载”两种条件下作答，用一组 Infisical 专属断言（SDK 包名、认证方式是否过时、Provider 细节等）打分。infisical-setup 的结果是加载后正确率 100%，不加载为 50%。该数据为官方自评，未见第三方复现，但方法与评分标准公开可查。
3. 适用场景
所属分类：集成与工作流自动化——该技能的核心是把 Infisical 这个第三方密钥管理服务接入到用户自己的项目与流水线中，属于“给应用接入第三方服务”的范畴。
适用人群：需要在项目里安全存取密钥、又不熟悉 Infisical 具体接入细节的开发者。典型场景：本地用 infisical run 注入密钥、给 Docker 镜像做构建期/运行期密钥注入、给 Kubernetes 接 Infisical Operator、在 GitHub Actions 用 OIDC 免密钥拉取机密、在应用代码里用对应语言 SDK 读取密钥。
4. 跨 Agent 兼容性
- Claude Code：原生支持——README 给出专用安装路径
.claude/skills/，并支持/plugin marketplace add与npx skills add两种安装方式 - Codex：原生支持——README 明确给出安装路径
~/.codex/skills/ - OpenClaw：未验证——README 声称遵循 Agent Skills 开放标准、“跨 45+ 工具通用”，但未点名 OpenClaw
- Hermes Agent：未验证——同上，未见点名
5. 推荐理由
刚开始接入 Infisical 的开发者最容易踩的坑不是“要不要用密钥管理”，而是“具体怎么接”：该用哪种认证方式、SDK 包名导入路径是否写对、Docker/K8s 场景下密钥怎么注入才不落盘明文。这个技能把这些细节整理成决策清单，并用公开的 A/B 数据证明能把回答准确率从 50% 提到 100%。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Infisical 主项目由官方团队维护，在 GitHub 有 28,514 星；但该 AI 技能配套仓库本身较新（首次提交 2026-04-10），仅 1 位贡献者、25 星，尚未见独立第三方讨论或评价 |
| 可用性 | 8 | 文档结构清晰、按使用场景拆分参考文件；提供公开可复现的 A/B 测试数据（100% vs 50%）作为效果证据；最近一次提交为 2026-04-19；但 Claude Code 插件市场安装路径存在一个自 2026-05-13 起未修复的已知 bug（见第 11 节），npx skills add 与手动复制两种安装方式不受影响 |
| 安全性 | 9 | 技能本身是纯文档/指令类内容，不含可执行脚本，不会自行发起网络请求或处理凭据；内容还主动引导用户使用短期机器身份认证、避免使用已弃用的 Service Token；仓库开源、MIT 许可、来自可审计的官方组织 |
安全检查清单：①无 shell 命令执行 ②技能本身不联网外发数据，仅指导用户配置 Infisical 官方 SDK/CLI ③不直接处理凭据，反而提醒“永不记录密钥明文”“服务令牌已弃用” ④未发现可疑指令或混淆内容 ⑤作者为 Infisical 官方团队，信誉良好 ⑥MIT 许可证明确 ⑦最近一次提交为 2026-04-19
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 infisical-setup 的差异 |
|---|---|---|
| azure-key-vault-py-microsoft-skills | 微软官方仓库下 Azure SDK 技能集的一员，专注 Azure Key Vault 的 Python SDK 接入 | 局限在 Azure 生态与单一语言（Python），不含 Docker/K8s/CI-CD 等跨平台接入指导；infisical-setup 覆盖 6 种语言 SDK 与多种部署形态，且平台本身开源、不绑定单一云厂商 |
| auth0-auth0-agent-skills | Auth0 官方身份认证服务接入技能，聚焦登录、令牌校验等身份认证流程 | 解决的是“验证用户是谁”的问题，与“存取应用机密”是相邻但不同的问题域；两者常被同时使用而非互相替代 |
8. 用户评价
该技能目前在第三方平台尚无独立、具名的用户评价。仓库内唯一的一条 Issue（#1，2026-05-13 提出，至今未关闭）反映的是 Claude Code 插件市场安装路径的一个具体配置错误，而非对技能内容质量的评价，已在第 11 节注意事项中记录。
9. 其他补充
Infisical 官方还公开了 Skills vs MCP 的对比数据：在 Python SDK、Node.js SDK、API 端点等测试用例上，技能与官方 Docs MCP 的回答准确率均达 100%，均显著高于无上下文时（0%~38%）。README 建议：若所用工具支持 MCP，优先接官方 Docs MCP（自动跟随文档更新、零维护）；仅当工具不支持 MCP、或需要离线/本地上下文时才选用本技能。
10. 安装使用方式
- Claude Code 插件市场：
/plugin marketplace add Infisical/ai-skills，随后/plugin install infisical-setup@infisical-ai-skills（⚠️ 该路径当前存在已知安装失败问题，见第 11 节） - 通用安装（支持 45+ 工具，含 Claude Code、Codex）：
npx skills add Infisical/ai-skills - 手动安装：从仓库
skills/infisical-setup/复制到对应 agent 的技能目录（Claude Code 为.claude/skills/，Codex 为~/.codex/skills/） - 安装后无需重启，技能通过描述中的触发词（如“infisical init”“连接 Infisical 到我的项目”等）自动被 agent 识别调用
11. 注意事项
- 已知安装 bug：通过 Claude Code 插件市场安装时，
marketplace.json的路径拼接存在缺陷，会导致/plugin install报“源路径不存在”而失败（Issue #1，自 2026-05-13 提出后未见修复）。受影响的仅是插件市场这一条安装路径，npx skills add与手动复制均可正常使用 - 该技能是“接入引导”而非密钥管理本身，使用前需要已有一个 Infisical 项目（云端或自托管均可）
- 仓库目前只有 1 位活跃贡献者，长期维护的持续性有待观察