揭秘构建体系NVIDIA Agent Skills的plugins打包与每日自动同步管线是如何工作的【免费下载链接】skillsAgent Skills for NVIDIA products — install into Claude Code, Codex, and other coding agents to run Physical AI, robotics, simulation, CUDA, and RAG workflows end to end.项目地址: https://gitcode.com/gh_mirrors/skills36/skillsNVIDIA Agent Skills是一个官方验证的 AI 代理技能目录仓库它把分散在各产品仓库中的 Agent SkillsPhysical AI、机器人、CUDA、RAG 等工作流技能通过plugins 插件打包与每日自动同步管线汇聚成统一目录让你用一条命令就能把 NVIDIA 官方技能装进 Claude Code、Codex 等编码代理。本文将拆解这套注册表 → 自动同步 → 插件打包的完整构建体系帮你理解目录里成百上千个技能是怎么持续更新的。一分钟看懂这个构建体系在解决什么问题每个技能都由产品团队在各自的产品仓库中维护而不是直接写进本仓库。本仓库skills36/skills本质上是一个目录 分发中枢四个核心位置各司其职角色位置作用产品注册表components.d/每个产品一个 yml 文件登记技能从哪个仓库哪个路径来插件构建源plugins.d/每个插件一个 yml 文件定义打包哪些技能与元数据技能目录skills/自动同步生成的最终目录一个文件夹对应一个技能插件产物plugins/自动生成的插件包分发给 Claude / Codex / Cursor 插件市场 核心设计原则skills/目录是唯一事实来源single source of truth每个 SKILL.md 只在那里存在一份plugins/ 下的内容每次构建都会重新生成官方明确提示不要手动编辑。第一步components.d 产品注册表 —— 团队如何零冲突上架想上架的团队只需新建一个文件如components.d/产品名.yml声明产品名称、来源仓库和每个技能的路径映射然后直接提 PR ——无需改动任何共享文件。必填字段name、repo、description、skills每项含path与catalog_dir为什么这样设计多团队的注册 PR 各改各的文件从根上消灭合并冲突完整 schema 与示例见 components.d/README.md注册表结构简化示意name: Your Product repo: owner/your-product skills: - path: skills/your-product-install/ catalog_dir: your-product-install每日自动同步管线五步把产品仓库变成可发布目录同步管线定义在 .github/workflows/sync-skills.yml 中由定时任务自动触发cron 配置每小时整点检查一次因此目录每天始终处于最新状态也支持手动触发。一次运行的完整流程如下。① 聚合注册表按需抓取管线先用yq把components.d/*.yml聚合成一份配置再对每个产品执行浅层稀疏克隆只拉取所需技能目录速度极快然后用 rsync 把技能同步到skills/catalog_dir/同步主体逻辑。若本轮一个技能都没同步成功管线会直接失败报警避免静默空转。② 签名漂移检测三重防线NVIDIA 对每个技能做签名验证管线在同步后逐个检查本次触碰过的目录漂移检测步骤防线发现的问题处理方式1源仓库根本没有skill.oms.sig已上架技能回滚到上次签名版本新技能直接丢弃2内容变了但签名没刷新漂移同上老的回滚新的丢弃3签名刷新了但内容与签名哈希不匹配视为源仓库自相矛盾同样回滚/丢弃被拦截的技能会写入追踪清单管线还会通过 git 历史自动定位当初上架该技能的负责人并 提醒联系人解析步骤方便源团队修复后重新签名。③ 合规检查三大必备文件每个技能必须同时携带以下文件否则直接从目录中剔除合规检查步骤SKILL.md—— 技能说明代理消费的主文件skill.oms.sig—— NVIDIA 分离签名skill-card.md—— 技能身份与治理卡片Tier-3 评估数据集evals.json或evals/、eval/目录下的 json没有任何 SKILL.md 的空产品目录也会被当作孤儿清理掉。④ 孤儿清理与滚动追踪从注册表移除的产品其目录会被 .github/scripts/prune-orphans.sh 删除单次超过 5 个目录时会拒绝执行并转人工处理有意保留的目录登记在 catalog-exceptions.yml所有被丢弃/回滚的技能会汇总到一个滚动追踪 Issue 中全部修复后 Issue 自动关闭⑤ 自动开 PR人工可审管线最后把本次变更整理成一份包含上游版本 SHA、变更清单、失败清单的 PR 描述并自动提交创建 PR 步骤。README 中的技能目录表格也随之自动重生成regenerate-readme.sh所以你看到的目录永远是最新状态。plugins 打包一份 YAML 生成三个插件市场插件打包的源文件在 plugins.d/由构建脚本 .github/scripts/build-plugins.py经 build-plugins.sh 一键运行解析生成生成物清单plugins/name/.claude-plugin/plugin.json—— Claude 插件清单plugins/name/.codex-plugin/plugin.json—— Codex 插件清单plugins/name/.cursor-plugin/plugin.json—— Cursor 插件清单三个顶层marketplace.json市场注册表plugins/name/skills/下的技能实体两个关键机制默认值继承plugins.d/_defaults.yml 提供版本号、作者、许可证、品牌色等公共字段单个插件的 yml 只写差异按浅合并方式覆盖默认值。copy vs symlink技能文件以真实副本copy默认还是符号链接进入插件包由skill_files字段控制。Codex 安装时会丢弃符号链接所以发布 Codex 必须用 copy仅供 Claude 或npx skills add的场景可用 symlink 避免重复存储模式说明。官方 nvidia-skills 插件的发现优先策略plugins.d/nvidia-skills.yml 揭示了一个值得学习的设计设计注释插件只打包一个技能nvidia-skill-finder而不是一股脑塞入大量技能。原因有三技能安装时会预加载 SKILL.md占用有限的上下文空间塞太多会互相抢戏由 finder 技能在用户提出任务时按需路由到 skills/ 目录中的任意技能整个目录随时可达技能版本与插件版本解耦单个技能更新不再需要插件重新发版反之亦然使用者视角安装与更新体验安装npx skills add nvidia/skills交互式选择技能与安装位置更新npx skills update可刷新已装技能并提示已被上游合并或删除的旧技能进阶安装与排障见 docs/advanced-install.mdx签名信任管线如何验证skill.oms.sig见 docs/agent-skill-trust-pipeline.mdx小结这套构建体系值得借鉴的 4 点实践实现注册表去中心化一文件一产品多团队并发上架零冲突供应链信任内建签名漂移三重防线 必备文件强制校验全程自动化、可审计自动 PR 滚动追踪 Issue 失败自动 负责人分发解耦技能目录与插件版本独立演进一套 YAML 多市场发布如果你想给某个产品上架技能新建components.d/slug.yml提 PR 即可若要新增插件在plugins.d/添加 yml运行构建脚本并提交生成物即可。贡献者的完整说明见 CONTRIBUTING.md。【免费下载链接】skillsAgent Skills for NVIDIA products — install into Claude Code, Codex, and other coding agents to run Physical AI, robotics, simulation, CUDA, and RAG workflows end to end.项目地址: https://gitcode.com/gh_mirrors/skills36/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考