openai/skills

技能简介 openai/skills 是 OpenAI 官方维护的 Agent Skills 技能目录仓库，面向 OpenAI Codex 等 AI 编程助手，提供标准化、可安装的技能包。Agent Skills 本质上是"文件夹格式的工作流包"——每个技能文件夹内含 SKILL.md 说明文档、脚本文件和相关资源，AI 编程助手在遇到对应任务时可以自动发现、加载并执行这些技能，将重复性高的开发流程封装为可复用的一键操作。项目采用 MIT 许可证，GitHub 已积累约 22000 个 stars 和 1500 个 forks，是 2026 年上半年增长最快的 Agent 工具类开源项目之一。 核心能力 开放标准兼容：技能文件遵循 agentskills.io 开放标准（SKILL.md 格式），已被 Microsoft（VS Code、GitHub Copilot）、Cursor、Goose、Amp、OpenCode 等多个平台和工具采纳，真正实现跨 Agent 的可移植性 三层技能体系：仓库按成熟度将技能分为三个层级——.system/（随 Codex 最新版自动安装的系统级技能）、.curated/（经过官方筛选的精选技能，可通过名称直接安装，如 $skill-installer gh-address-comments）、.experimental/（社区实验性技能，需指定 GitHub 路径安装） 渐进式加载：技能元数据先以轻量摘要形式加载（约 8000 字符上限），只有当 AI 确定要调用该技能时才会读取完整的 SKILL.md，有效控制上下文窗口开销 Symphony 编排规范：2026 年 4 月发布的 Symphony 规范扩展了 Skills 的使用边界——从单个技能调用扩展为"多 Agent 舰队编排"，通过 Linear 等 Issue 追踪器驱动多个 Codex Agent 并行工作，结果由人工审核，形成完整的 AI 工程化闭环 社区可扩展：任何开发者均可通过 PR 向 .experimental 目录提交新技能，项目维护者会定期将从实验性技能中表现优秀者晋升为精选技能 安装配置 系统级安装：.system 目录下的技能随 Codex 最新版自动安装，无需任何手动操作，更新 Codex 版本即可获取最新系统技能 精选技能安装：通过 Codex CLI 的技能安装命令即可按名称安装，例如 $skill-installer gh-address-comments，安装后 Codex 自动检测，无需重启 实验性技能安装：从 GitHub 克隆仓库后，指定 experimental 目录下的技能文件夹路径即可加载，支持社区开发的任意自定义技能 其他 Agent 平台：遵循 agentskills.io 标准的 Agent 均支持安装 Skills——Claude Code 用户将技能文件夹放入 ~/.claude/skills/ 目录，OpenCode 用户放入对应配置路径即可 使用步骤 在 Codex CLI（或任何兼容 Agent Skills 标准的编程助手）中，确认 Skills 功能已启用 通过 $skill-installer gh-address-comments 等命令安装所需技能，或手动将技能文件夹放入 Agent 的 skills 目录 在编码会话中，直接以自然语言描述需求——例如"帮我用这个技能生成规范的项目 README"——AI 会自动判断是否调用相关技能 AI 调用技能后，会自动按照技能内 SKILL.md 的规范执行对应的脚本和指令流程 如需禁用某个技能而不删除，直接在 Agent 配置文件中将其关闭即可，技能文件保留在目录中供后续重新启用 适用场景 代码审查自动化：安装代码审查类技能，让 Agent 在提交 PR 前自动执行审查清单，减少人工 Review 负担 文档生成：通过文档写作类技能，Agent 可自动生成符合项目规范的 API 文档、CHANGELOG、贡献指南等 Issue 流转自动化：安装 GitHub Issue 相关的技能后，Agent 可以直接操作 Issue——创建、评论、标注、更新状态，形成工程化工作流 跨仓库统一工程规范：在团队内部维护一套标准化 Skills，通过 Git 共享给所有成员，保证不同开发者的 AI 编程助手输出一致 适用人群 使用 OpenAI Codex、Claude Code、Cursor、GitHub Copilot、OpenCode 等 AI 编程助手的开发者，特别是需要在团队中统一 AI 开发规范、提升 AI 编程工作流可复用性的工程团队负责人和高级开发者。对 AI 编程有一定使用经验、希望将重复性工作交给 Agent 自动完成的技术人员同样适用。 工作原理 Agent Skills 的核心是 SKILL.md 文件——一个包含元数据、使用说明、脚本资源的 Markdown 文件。当用户在 AI 编程助手中触发技能调用时，Agent 会在配置的技能目录中检索匹配的技能元数据，加载对应的 SKILL.md，然后按照文件中定义的指令序列执行具体操作。技能可以是纯指令性的（告诉 Agent 应该如何执行某类任务），也可以包含实际的脚本文件供 Agent 调用。整个过程不需要额外的运行时环境，纯文本定义即可驱动 AI 执行复杂的多步骤任务。 官方链接 GitHub 仓库：https://github.com/openai/skills Agent Skills 开放标准：https://agentskills.io