Skills.sh 完全入门指南

用费曼学习法掌握 AI Agent 技能生态

---

🧭 一句话定义

Skills.sh 是 AI 智能体的"应用商店"。

就像手机需要 App 才能拍照、导航，AI 智能体需要"技能包"才能执行专业任务。

---

第一步：理解核心概念

它解决了什么问题？

想象你有一个聪明的实习生（AI 智能体），但他刚入职，对你们团队的技术规范一无所知：

• ❌ 没有 Skills：每次都要手把手教——“我们 React 项目要用 Zod 做校验，API 路由要这样写……”
• ✅ 用了 Skills：安装 vercel-react-best-practices 技能包，AI 自动掌握团队规范，无需重复解释。

技术本质是什么？

概念	解释
技能（Skill）	一个包含 SKILL.md 文件的文件夹
SKILL.md	给 AI 的"操作手册"（YAML 配置 + Markdown 指令）
生态	支持 38+ 主流 AI 工具，包括 Claude Code、Cursor、GitHub Copilot、Windsurf 等

---

第二步：用类比简化理解

类比：餐厅厨房

现实世界	Skills.sh 世界
餐厅（厨房 + 厨师）	AI 智能体（如 Claude Code）
菜谱（教厨师做菜）	Skill（教 AI 做特定任务）
即开即用的调料包	npx skills add 一键安装
中央厨房（统一配送）	skills.sh 技能市场
卫生检疫（安全认证）	Snyk + Gen Trust Hub 安全扫描

核心命令速记

# 安装技能 → 给 AI 买一本专业书
npx skills add <作者/仓库>

# 查看已安装 → 检查 AI 的书架
npx skills list

# 搜索技能 → 去书店找书
npx skills find [关键词]

# 更新技能 → 获取最新版教材
npx skills update

---

第三步：动手实践

场景一：让 AI 掌握 React 最佳实践

# 安装技能（像 npm install，但是给 AI 装"大脑"）
npx skills add vercel-labs/agent-skills

安装后，当你让 AI “帮我创建一个登录表单”，它会自动：

• 使用 TypeScript 严格模式
• 用 Zod 做表单校验
• 遵循 Next.js App Router 规范
• 处理错误边界

场景二：搜索发现新技能

# 交互式模糊搜索
npx skills find

# 按关键词精确搜索
npx skills find typescript security

场景三：创建团队内部技能（沉淀团队知识）

第一步：生成模板

npx skills init my-team-rules

第二步：编辑 SKILL.md

---
name: my-team-api-rules
description: 团队API设计规范——RESTful风格，强制JWT认证，错误码遵循RFC 7807
---

# 团队 API 规范

## 强制检查清单
1. 所有端点必须以 `/api/v1/` 开头
2. 必须包含 `X-Request-ID` 请求头
3. 错误响应格式必须符合 RFC 7807

## 示例对比
❌ 错误：返回纯文本 "Error occurred"
✅ 正确：返回 {"type": "/errors/invalid-input", "title": "Invalid email", "status": 400}

第三步：推送并共享

# 推送到 GitHub 后，团队成员即可一行命令安装
npx skills add 你的用户名/my-team-rules

---

第四步：回顾与深化

常见误区澄清

误区	真相
“Skills 是代码库/依赖包”	❌ 不是。Skills 是给 AI 的指令集，不是给人用的库
“安装后自动全局生效”	⚠️ 取决于具体 Agent。有的自动加载，有的需在提示词中显式引用
“Skills 只是文档”	❌ 可包含可执行脚本，AI 能直接调用运行
“所有 Skill 都安全”	⚠️ 即使有 Snyk 扫描，安装前仍建议人工审阅源码

⚠️ 安全红线（必看）

Skills 是 AI 的"超能力"，也可能是"特洛伊木马"。

安装前务必检查以下三点：

1. 权限范围：是否需要访问文件系统、发起网络请求、读取环境变量？
2. 外部依赖：是否会调用不明 API 或下载额外脚本？
3. 作者信誉：优先选择官方认证来源（Vercel、Microsoft、Anthropic 等）。

生态全景

┌──────────────────────────────────────────┐
│         技能分发层  (skills.sh)           │
│    排行榜 · 分类浏览 · 安全认证徽章        │
├──────────────────────────────────────────┤
│         CLI 工具层  (npx skills)         │
│    安装 · 更新 · 搜索 · 创建脚手架        │
├──────────────────────────────────────────┤
│         智能体层  (38+ 平台)              │
│  Claude Code │ Cursor │ Copilot │ ...   │
├──────────────────────────────────────────┤
│         执行层  (你的项目)                │
│    代码生成 · 重构 · 审计 · 部署…         │
└──────────────────────────────────────────┘

何时该用 Skills？

场景	建议
团队新人频繁写出不符合规范的代码	✅ 安装内部 Skill，固化团队规范
每次都要向 AI 重复解释同一套架构规则	✅ 创建 Skill，一劳永逸
需要 AI 操作特定工具（发邮件、查日历等）	✅ 安装对应工具 Skill
一次性临时任务，没有复用价值	❌ 直接写提示词即可，无需安装

---

🎯 费曼式总结

Skills.sh 让 AI 智能体从**“什么都懂一点的通才学生"变成"持证上岗的专业技师”**——通过安装不同的技能包，AI 能立即掌握特定领域的最佳实践、工具链与团队规范，而这些技能就像手机 App 一样，可以被发现、安装、更新和共享。

---

🚀 快速开始

# 安装官方推荐技能包
npx skills add vercel-labs/agent-skills

# 浏览更多技能
open https://skills.sh

参考资源

• 官方站点：skills.sh
• 技能规范：agentskills.io
• 安全合作：Snyk × Vercel 公告