Agent Skills 技能库怎么选：精选来源与安全检查清单

Agent Skill 通常由一份说明文件、可选参考资料和辅助脚本组成。它能让 AI 在特定任务里遵循稳定流程，也意味着其中的指令和脚本会影响工作方式。收藏数量只能帮助发现项目，不能证明技能安全、适配当前 Agent，或允许复制它的内容。

先分清三类资源

规范定义技能怎样描述和打包，不是技能商店，也不是安全认证。
内容仓库提供 SKILL.md、参考资料和可能执行的脚本；具体许可和行为要逐个目录检查。
安装器或插件管理器负责发现、临时使用、复制/链接和更新；它本身也可能访问网络或写入技能目录。

值得关注的来源

下表中的星标来自各项目 GitHub 页面在 2026-10-21 的读取快照。数字会变化，只用于检索热度，不构成排名、质量证明或安全背书。

来源	GitHub 星标快照	类型与适用方向	使用前要知道
obra/superpowers	302.6k	MIT 技能框架与开发方法；包含调试、TDD、计划、代码审查和分支收尾等流程	触发规则较强，部分工作流涉及子代理、Git worktree 或自动更新；先选一个工作流单独试用，不要默认套用全部约束
mattpocock/skills	299k	MIT 工程工作流技能；本机 `skills-main` 快照的来源，逐项用途见本机技能清单	本机快照标记为 1.2.3，但没有 Git 元数据；不能据此断言它与上游某个提交逐字节一致
Anthropic Skills	182.5k	Anthropic 发布的技能示例，覆盖开发、创作和文档任务	README 说明仓库中许多技能采用 Apache-2.0，同时 `docx`、`pdf`、`pptx`、`xlsx` 技能是 source-available 而非开源；不要把某个目录的许可推到整仓
GitHub Awesome Copilot	40.2k	社区贡献的 Copilot 技能、指令、Agent、Hook、工作流和插件；仓库许可为 MIT	这是多种扩展的集合，不全是通用 `SKILL.md`；社区贡献内容仍要读正文、脚本和所需权限
VoltAgent Awesome Agent Skills	36.1k	1000+ 官方团队与社区技能链接的跨 Agent 发现目录；目录仓库为 MIT	它主要是索引，不是统一打包的技能库；目录许可不覆盖链接目标，点进原作者仓库后再检查
Skills CLI	35.9k	MIT 安装/发现工具，支持 Codex 等多种 Agent	它是工具而不是技能内容。CLI 的许可不会改变被安装技能的许可、风险或权限
Vercel Agent Skills	32.7k	Vercel 官方集合；包括 React/Next.js 性能、界面审查和写作规范	README 声明 MIT，但当前仓库没有根目录 `LICENSE` 文件，且有公开 Issue 请求补齐许可文本；使用前需确认具体技能许可。部署技能还会上传项目归档，见下方安全复核
Agent Skills 规范	26.3k	Apache-2.0 规范与文档；说明 `SKILL.md`、可选脚本、参考资料、资源文件及渐进披露	它不是技能目录或安全认证；格式合规不代表其中指令安全
Google Agent Skills	21.4k	Google 官方 Apache-2.0 技能，覆盖 Google Cloud、Gemini、数据和基础设施	有些流程需要云账号、权限和已启用服务；先核对是否会创建资源、产生费用或接触敏感数据

2026-10-20 部署技能安全复核

截至 2026-10-20 复核的 vercel-labs/agent-skills 主分支 v3.0.0 将部署技能命名为 deploy-to-vercel。它的 Codex 无认证脚本会把项目复制到临时目录、打成 tar 包，再将整个归档 POST 到 codex-deploy-skills.vercel.sh。脚本明确排除 node_modules、.git、.env 和 .env.*，但没有读取 .gitignore 或 .vercelignore；例如本地数据库、导出文件、证书、.npmrc 或其他秘密文件仍可能被包含。技能说明还把 CLI 未安装或认证失败作为回退条件，没有要求先列出上传文件并取得对第三方传输的单独确认。

GitHub 上的 Issue #335（截至 2026-10-20 仍为 Open）报告了类似的全目录上传与忽略规则问题。该 Issue 描述的是指定历史提交；本次另行只读检查了当前主分支的 Codex 脚本，确认当前仍存在“不按忽略文件过滤、只按少数固定名称排除”的风险类别。它不证明发生过泄露，也不能代替对任一未来版本的复核。

结论：不要把 deploy-to-vercel 当作私有项目的默认部署方式，也不要在含公司源码、凭据、数据库或个人数据的目录中运行无认证回退脚本。 需要部署时，先检查并明确选择上传清单；优先使用已认证的官方 CLI 部署明确的构建目录，并单独确认目标账号、预览/生产环境和网络上传。只使用 React 性能、界面或写作指南时，也先审阅对应技能正文与引用文件。

许可方面，当前 README 写有 MIT，但仓库根目录的 LICENSE 路径返回 404；Issue #334 也指出缺少可核验的许可证文本。故不能仅凭 README 宣称就把它当成已确认可再分发的 MIT 内容。

GitHub awesome-copilot 的 README 说明其资源由社区贡献；VoltAgent README 也把自己定位为大量来源的聚合目录。两者都适合找候选，不应该被当作逐项安全审计结果。若只需要了解文件格式，直接看 Agent Skills 规范；如果要找能马上解决任务的技能，再回到发布者仓库审查具体目录。

可以先试的具体技能

技能	用途	适用边界
Superpowers `systematic-debugging`	分阶段复现、缩小原因并验证修复	技能流程不能替代故障授权、服务保护或现有项目规范
Superpowers `test-driven-development`	用失败测试明确行为，再做最小实现	本机已安装适配版本，固定到 `b739a8af570e10a95898f2bdf6cec97467fa6c12`；遵守项目测试约定，不为文档改动硬造测试
Superpowers `verification-before-completion`	完成前逐项核对验证证据	检查范围仍由当前任务决定，不能声称测试覆盖未运行的设备或生产场景
Vercel `react-best-practices`	React/Next.js 性能规则；README 介绍 40+ 条、8 个类别	项目使用 React/Next.js 时更相关；结论必须结合本项目版本验证，并确认该目录的许可
Matt Pocock `research`	优先查一手文档、规范和源代码，并给事实附上可追溯来源	本机安装了适配版；不会强制后台代理或强制新建文件
Matt Pocock `codebase-design`	比较接口深度、调用成本、内聚性与测试边界	本机安装了适配版；不为了“深模块”增加空洞抽象，也不删除有价值的既有测试
Vercel `web-design-guidelines`	UI 可访问性、交互和 UX 规则审查	本机采用提交 `063bee94c3f4df8453406c830b0a7df0f2860278`；规则每次审查时从上游 raw URL 获取，需把下载内容视为外部数据。仓库 README 声明 MIT，但根目录没有 `LICENSE`，仅保留本机个人使用，不再分发正文
Vercel `deploy-to-vercel`	将项目打包并通过无认证端点创建可认领部署	默认不推荐在私有代码或含敏感文件的项目运行；先审阅完整上传清单、脚本与许可，并取得单独上传确认
Anthropic `webapp-testing`	Playwright Web 测试示例	运行 helper 前检查脚本、服务生命周期、浏览器权限和目录内许可
Anthropic `mcp-builder`	Node/TypeScript 或 Python MCP 服务设计示例	仅在确实开发 MCP 服务时使用；该目录许可不能代表仓库其他目录
GitHub Copilot 技能	在 Copilot CLI/IDE 中使用仓库维护的工作流模板	与特定产品集成的资源要核对目标 Agent 和依赖，不要直接塞进 Codex 全局目录

首轮只建议试一个流程：日常修复可从 systematic-debugging 或 test-driven-development 开始；React 项目再评估 Vercel 性能规则。不要同时启用多个会强制不同计划格式、分支策略或子代理方式的全流程框架。

本机已安装的精选子集

截至 2026-10-21，本机用户级 Codex 技能目录中有 9 项经过来源与内容核对的精选技能。它们是按工作场景筛出的指南，不是把某个上游仓库整体复制进来：

本机技能	来源与许可	使用边界
`playwright`	OpenAI curated skills；Apache-2.0	浏览器自动化包装器可能调用 `npx`；安装技能不等于安装浏览器或 Playwright 全局包
`security-best-practices`	OpenAI curated skills；Apache-2.0	安全审查参考，不替代针对项目的测试、威胁建模或专业安全评估
`diagnosing-bugs`	`mattpocock/skills` 本机 1.2.3 快照；MIT 根许可	本地版本调整为自主诊断，并强调生产、浏览器和秘密信息保护；快照没有 Git 提交元数据
`code-review`	`mattpocock/skills` 本机 1.2.3 快照；MIT 根许可	以只读方式检查正确性、安全和需求；按当前任务推断合理基线，不擅自发起子代理
`codebase-design`	`mattpocock/skills` 本机 1.2.3 快照；MIT	附完整许可和两份参考文档；已调整为保护旧测试、避免强制子代理和审批停顿
`research`	`mattpocock/skills` 本机 1.2.3 快照；MIT	附完整许可；查一手资料并注明时效和推断，不强制另存文件或启动后台任务
`test-driven-development`	`obra/superpowers`，固定提交 `b739a8af570e10a95898f2bdf6cec97467fa6c12`；MIT	附完整许可；保留 Red/Green/Refactor 核心，同时服从仓库规范并保护用户已有修改
`vercel-react-best-practices`	`vercel-labs/agent-skills`，固定提交 `063bee94c3f4df8453406c830b0a7df0f2860278`	技能元数据声明 MIT，但所查来源树缺完整许可证文本；只保留本机使用，不再分发其正文
`web-design-guidelines`	`vercel-labs/agent-skills`，固定提交 `063bee94c3f4df8453406c830b0a7df0f2860278`	单文件说明，无辅助脚本或依赖；每次审查需读取上游规则。README 声明 MIT，但根目录无 `LICENSE`；仅本机使用，不再分发正文

新增的 TDD、模块设计和研究指南没有强制启动后台子代理，也没有新增脚本或运行依赖；这不代表别的技能没有命令、网络或上传行为，仍须按单项审查。完整版本、路径和许可证记录见本机技能清单。

发现、预览和安装

Skills CLI 支持列出、临时使用、安装和移除技能。以下命令是供人工审查的示例，本次没有运行：

npx skills add OWNER/REPO --list
npx skills use vercel-labs/agent-skills --skill react-best-practices --agent codex
npx skills add vercel-labs/agent-skills --skill react-best-practices --agent codex
npx skills list
npx skills remove SKILL_NAME

如果要在 Codex 中使用 Matt Pocock 的原生插件，上游当前 README 还提供了插件市场安装入口（桌面端也可从插件侧栏搜索并添加）：

codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock

原生插件与 Skills CLI 的文件复制是两条不同的分发路线；同一个 Agent 只选一种，避免重复加载两份相同技能。命令来自上游 README 的 2026-10-19 快照，没有在本机执行；安装前核对当前 Codex 版本和插件确认界面。

临时使用会把选中的技能说明提供给 Agent；安装会写入项目或用户级目录。执行前确认交互界面显示的 Agent、技能名称和安装范围，不要对陌生来源使用 --all。GitHub Awesome Copilot README 还列出 gh skills install 安装方式，但需先确认本机 GitHub CLI 版本是否满足它要求。

安装前逐项审查

阅读 SKILL.md、相对路径引用文件和全部脚本，确认它要求 Agent 做什么。
查清总许可证、目标目录的单独许可、引用资产和脚本依赖；不要仅凭仓库首页一行许可作结论。
检查 Shell/Hook 命令、网络访问、遥测、自动更新、读写路径，以及任何索取密钥或削弱权限的要求。
优先在项目级或隔离副本中只启用一个技能；确认运行上下文不含生产密钥、无关用户数据或公司内部材料。
在低风险任务上试用，复核 Agent 实际读取的文件、执行的命令、网络请求和改动。
记录来源 URL、技能名称、固定版本/提交、许可、安装范围和本地修改；更新后重新审查差异。

技能格式兼容不等于行为兼容。不同 Agent 对自动触发、Hooks、子代理、MCP、终端权限和写文件的支持并不相同。高星、官方发布、MIT/Apache 许可都不是免审理由；任何要求上传无关源码、打印凭据、绕过权限或运行破坏性命令的指令，都应停止并查明影响。

维护建议

每季度复核来源、固定版本、更新记录、许可与 Agent 兼容性；发生安全公告时立即复核。
项目级技能通过代码评审维护；生产运维技能必须写清授权、备份、停止、验证和回滚步骤。
多个全流程框架不要叠加。先检查触发规则和默认行为是否冲突，再决定保留一个主流程或只取其中独立技能。
上游停止维护或星标变化时，不必机械删除；对照功能、风险、替代方案和锁定版本策略后再决定。

来源

本文是来源导航和使用建议，不复制第三方 SKILL.md 正文。上述精选技能中，Superpowers TDD 固定到已审查的提交；Matt Pocock 的本机来源是带 MIT 根许可证的 1.2.3 快照，但没有 Git 元数据，不能声称与某个上游提交逐字节相同。具体技能和许可会变动，采用前要回到作者维护的页面核验；安装技能也不代表其脚本已经执行或获得了生产环境授权。