安装第一个 Skill：选择、验证与更新怎么做？

先挑一个反复出现的问题

把目标写成具体任务，例如审查 React 页面中的重复请求，或按团队格式整理发布记录。Skill 的价值在于提供可重复的方法；安装数量不是效果指标。

阅读触发描述和完整指令，再检查引用文档与 scripts 目录。重点确认它要求读取什么、运行什么，以及是否需要外部账号。技能里的安装命令也需要单独理解。

明确项目范围与客户端

Skills CLI 支持按技能和 Agent 选择安装。默认项目范围便于随代码审查与团队共享；全局范围会影响多个项目，应单独管理。不同客户端识别目录与插件机制不同，以当前官方说明为准。

安装完成后检查新增文件、符号链接及 Git diff。不要把私人凭据与个人配置一起提交。插件可能同时包含 Skills、MCP 或其他能力，不能只检查 SKILL.md 就认为已了解全部内容。

验证是否真正改善了任务

选一个你能判断对错的小任务，写清预期输出、允许修改的范围和检查方式。确认客户端加载了技能，然后比较结果是否符合技能中的规则。仅看到安装成功，不能证明任务执行时采用了它。

出现冲突时先检查多套规则是否重复或互相矛盾。先保留一套相关技能，再逐步增加；代码任务仍要检查差异并运行项目已有验证。

把更新当作一次代码变更

保留来源仓库、安装版本或提交、目标客户端与验证任务。更新前检查上游变更，尤其是新脚本、网络请求和权限要求；不要在关键项目里无差别自动更新所有来源。

更新后重跑同一个小任务。若结果退步，恢复已有配置或记录的版本；移除技能也要检查全局安装和其他客户端是否仍有副本。

先列出技能，再检查安装状态

npx skills add vercel-labs/agent-skills --list

# 阅读并选择技能后，再交互式安装
npx skills add vercel-labs/agent-skills

# 查看当前项目的安装结果
npx skills list

示例依据本页所列上游 README；npx 会下载并执行 npm 包。首次安装先核对包与仓库来源，团队使用时记录实际版本。

开始前检查

• 阅读了技能指令、引用资源和脚本
• 明确项目或全局范围以及目标客户端
• 用一个真实小任务验证加载和效果
• 更新有来源版本、差异检查和回退记录