🌙 Skills 入门指南
使用 Skills 扩展 AI Agent 的能力
🌙 📚 目录
🌙 什么是 Skills
Skills 是一个开放的生态系统,为 AI Agent(如 Claude Code)提供专业化的知识、工作流程和工具集成。
🌙 核心概念
- Skill:一个包含特定领域知识的模块化包
- Skills CLI:管理和安装 skills 的命令行工具(
npx skills) - Skills 生态:由社区和官方维护的 skills 仓库集合
- 全局 vs 项目级:可以全局安装或在特定项目中安装
🌙 Skills 的工作原理
当你安装一个 skill 后:
- Skill 文件被复制或链接到
~/.claude/skills/目录 - Claude Code 在执行任务时自动加载相关 skills
- Skills 提供上下文、最佳实践和代码模板
- 帮助 AI 生成更专业、更符合标准的代码
现在可以安装到全局的
~/.agent/skills目录,可以给cursor等IDE使用
🌙 为什么使用 Skills
🌙 对开发者的好处
提升代码质量
- 遵循行业最佳实践
- 符合框架官方推荐模式
- 减少常见错误
加速开发效率
- 减少重复性工作
- 快速生成样板代码
- 自动应用设计模式
降低学习曲线
- 快速上手新技术栈
- 获得专家级指导
- 了解框架深层知识
保持技术更新
- Skills 持续更新
- 跟随技术演进
- 学习最新特性
🌙 适用场景
- 学习新的技术栈(如前端转全栈)
- 优化现有代码库
- 遵循团队规范
- 快速原型开发
- 代码审查和重构
🌙 安装 Skills CLI
Skills CLI 基于 npx,无需全局安装即可使用:
# 直接使用(推荐)
npx skills --help
# 或全局安装
npm install -g skills
1
2
3
4
5
2
3
4
5
🌙 验证安装
npx skills --version
1
🌙 快速开始
🌙 1. 搜索 Skills
交互式搜索:
npx skills find
1
关键词搜索:
npx skills find react
npx skills find golang
npx skills find api design
1
2
3
2
3
🌙 2. 安装 Skills
安装单个 Skill(全局):
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y
1
查看仓库中的所有 Skills:
npx skills add vercel-labs/agent-skills -l
1
安装特定 Skills:
npx skills add vercel-labs/agent-skills --skill pr-review,commit -g -y
1
🌙 3. 查看已安装的 Skills
# 查看全局 skills
npx skills list -g
# 查看项目 skills
npx skills list
1
2
3
4
5
2
3
4
5
🌙 4. 使用 Skills
安装后,Claude Code 会自动在相关任务中使用这些 skills。无需额外配置!
示例:
- 安装
nextjs-app-router-patterns后,创建 Next.js 页面时会自动应用最佳实践 - 安装
golang-backend-development后,编写 Go API 时会遵循标准模式
🌙 常用命令
🌙 搜索与安装
# 交互式搜索
npx skills find
# 关键词搜索
npx skills find [query]
# 安装 skill(全局)
npx skills add <owner/repo@skill> -g -y
# 列出仓库中的 skills
npx skills add <owner/repo> -l
# 安装仓库所有 skills
npx skills add <owner/repo> --all
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
🌙 查看与管理
# 列出全局 skills
npx skills list -g
npx skills ls -g
# 列出项目 skills
npx skills list
npx skills ls
# 按 agent 筛选
npx skills ls -a claude-code
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
🌙 删除 Skills
# 交互式删除
npx skills remove
npx skills rm
# 删除特定 skill(全局)
npx skills remove <skill-name> -g
# 删除所有 skills
npx skills remove --all -g
# 跳过确认
npx skills remove <skill-name> -g -y
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
🌙 更新 Skills
# 检查更新
npx skills check
# 更新所有 skills
npx skills update
1
2
3
4
5
2
3
4
5
🌙 创建自定义 Skill
# 初始化新 skill
npx skills init my-skill
# 在特定目录初始化
npx skills init my-project/my-skill
1
2
3
4
5
2
3
4
5
🌙 推荐 Skills
🌙 🎯 前端开发(Next.js + React)
🌙 Next.js
# Next.js App Router 模式(6.5K 安装)⭐
npx skills add wshobson/agents@nextjs-app-router-patterns -g -y
# Next.js 最佳实践(2.4K 安装)
npx skills add sickn33/antigravity-awesome-skills@nextjs-best-practices -g -y
# Next.js + Supabase 认证(2.8K 安装)
npx skills add sickn33/antigravity-awesome-skills@nextjs-supabase-auth -g -y
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
🌙 React
# Vercel React 最佳实践(185.8K 安装)⭐ 必装
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y
# React 性能优化(444 安装)
npx skills add nickcrew/claude-ctx-plugin@react-performance-optimization -g -y
# React 组件开发(11.1K 安装)
npx skills add google-labs-code/stitch-skills@react:components -g -y
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
🌙 Tailwind CSS
# 高级布局(1.9K 安装)⭐
npx skills add josiahsiegel/claude-plugin-marketplace@tailwindcss-advanced-layouts -g -y
# 动画效果(672 安装)
npx skills add josiahsiegel/claude-plugin-marketplace@tailwindcss-animations -g -y
# 移动优先设计(613 安装)
npx skills add josiahsiegel/claude-plugin-marketplace@tailwindcss-mobile-first -g -y
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
🌙 TypeScript
# TypeScript 高级类型(10.6K 安装)⭐
npx skills add wshobson/agents@typescript-advanced-types -g -y
# TypeScript 专家(1.9K 安装)
npx skills add sickn33/antigravity-awesome-skills@typescript-expert -g -y
# OpenAPI 转 TypeScript(2.9K 安装)
npx skills add softaworks/agent-toolkit@openapi-to-typescript -g -y
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
🌙 🚀 后端开发(Go)
# Go 后端开发(319 安装)⭐
npx skills add manutej/luxor-claude-marketplace@golang-backend-development -g -y
# Go Clean Architecture(27 安装)
npx skills add eng0ai/eng0-template-skills@go-backend-clean-architecture -g -y
# Go 微服务(60 安装)
npx skills add mindrally/skills@go-backend-microservices -g -y
# Go 后端审查(21 安装)
npx skills add jssfy/k-skills@go-backend-reviewer -g -y
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
🌙 🔌 API 设计
# API 设计(4.1K 安装)⭐
npx skills add supercent-io/skills-template@api-design -g -y
# REST API 设计模式(65 安装)
npx skills add manutej/luxor-claude-marketplace@rest-api-design-patterns -g -y
# API 模式(436 安装)
npx skills add sickn33/antigravity-awesome-skills@api-patterns -g -y
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
🌙 🗄️ 数据库
# 数据库 Schema 设计(4.1K 安装)⭐
npx skills add supercent-io/skills-template@database-schema-design -g -y
# PostgreSQL(3.6K 安装)
npx skills add neondatabase/agent-skills@neon-postgres -g -y
# 数据库迁移(3.2K 安装)
npx skills add wshobson/agents@database-migration -g -y
# Prisma ORM(1.2K 安装)
npx skills add prisma/skills@prisma-database-setup -g -y
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
🌙 🧪 测试
# 后端测试(4.1K 安装)⭐
npx skills add supercent-io/skills-template@backend-testing -g -y
# 测试策略(4.1K 安装)
npx skills add supercent-io/skills-template@testing-strategies -g -y
# E2E 测试(4.8K 安装)
npx skills add wshobson/agents@e2e-testing-patterns -g -y
# Web 应用测试(17.4K 安装)
npx skills add anthropics/skills@webapp-testing -g -y
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
🌙 🐳 部署与容器化
# Docker 专家(75 安装)
npx skills add personamanagmentlayer/pcl@docker-expert -g -y
# Docker 部署(108 安装)
npx skills add pluginagentmarketplace/custom-plugin-nodejs@docker-deployment -g -y
1
2
3
4
5
2
3
4
5
🌙 管理 Skills
🌙 查看已安装的 Skills
# 查看全局 skills
npx skills ls -g
# 查看项目 skills
npx skills ls
# 按 agent 筛选
npx skills ls -a claude-code
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
🌙 删除 Skills
交互式删除(推荐):
npx skills remove -g
1
删除特定 Skill:
npx skills remove <skill-name> -g -y
1
批量删除所有 Skills:
npx skills remove --all -g -y
1
🌙 更新 Skills
# 检查可用更新
npx skills check
# 更新所有 skills
npx skills update
1
2
3
4
5
2
3
4
5
🌙 Skills 存储位置
- 全局 Skills:
~/.claude/skills/ - 项目 Skills:
./claude/skills/
手动清理:
# 删除所有全局 skills
rm -rf ~/.claude/skills/*
# 删除特定 skill
rm -rf ~/.claude/skills/<skill-name>
1
2
3
4
5
2
3
4
5
🌙 最佳实践
🌙 1. 按需安装,避免过度安装
推荐:
# 只安装核心 skills
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y
npx skills add wshobson/agents@nextjs-app-router-patterns -g -y
1
2
3
2
3
不推荐:
# 避免一次性安装大量不常用的 skills
npx skills add owner/repo --all
1
2
2
🌙 2. 定期更新
# 每周检查一次
npx skills check
# 更新所有
npx skills update
1
2
3
4
5
2
3
4
5
🌙 3. 使用全局安装
对于常用 skills,使用 -g 标志全局安装:
npx skills add <skill> -g -y
1
🌙 4. 定期清理
# 查看已安装的
npx skills ls -g
# 删除不需要的
npx skills remove -g
1
2
3
4
5
2
3
4
5
🌙 5. 优先选择热门 Skills
- 查看安装数:数字越大,说明使用者越多
- 优先选择官方维护的 skills(如 Vercel、Anthropic)
- 查看 https://skills.sh/ 了解详情
🌙 6. 技术栈组合推荐
前端开发者核心包:
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y
npx skills add wshobson/agents@nextjs-app-router-patterns -g -y
npx skills add wshobson/agents@typescript-advanced-types -g -y
1
2
3
2
3
全栈开发者核心包:
# 前端
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y
npx skills add wshobson/agents@nextjs-app-router-patterns -g -y
# 后端
npx skills add manutej/luxor-claude-marketplace@golang-backend-development -g -y
npx skills add supercent-io/skills-template@api-design -g -y
# 数据库
npx skills add supercent-io/skills-template@database-schema-design -g -y
# 测试
npx skills add supercent-io/skills-template@backend-testing -g -y
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
🌙 常见问题
🌙 Q1: Skills 和普通提示词的区别?
Skills:
- 模块化、可重用
- 社区维护和更新
- 自动在相关任务中激活
- 包含完整的上下文和最佳实践
普通提示词:
- 一次性使用
- 需要手动输入
- 缺乏结构化知识
🌙 Q2: 安装太多 Skills 会影响性能吗?
不会。Claude Code 只在相关任务时加载对应的 skills。但建议按需安装,保持管理简洁。
🌙 Q3: Skills 可以离线使用吗?
可以。一旦安装,skills 存储在本地,无需网络连接即可使用。
🌙 Q4: 如何知道某个 Skill 是否在工作?
Claude Code 在使用 skill 时会自动应用其知识。你可以通过生成代码的质量和模式来判断。
🌙 Q5: 可以创建自己的 Skills 吗?
可以!使用以下命令:
npx skills init my-skill
1
然后在 SKILL.md 文件中编写你的知识和指导。
🌙 Q6: Skills 支持哪些 AI Agent?
主要支持:
- Claude Code
- Cursor
- Windsurf
- 其他支持 Agent Skills 协议的工具
🌙 Q7: Skills 是免费的吗?
是的!Skills 生态完全开源和免费。
🌙 Q8: 如何贡献到 Skills 生态?
- 创建自己的 skill
- 发布到 GitHub
- 在 https://skills.sh/ 提交
- 分享给社区
🌙 Q9: Global vs Project 安装的区别?
Global(-g):
- 安装到
~/.claude/skills/ - 所有项目共享
- 适合通用 skills
Project:
- 安装到项目的
.claude/skills/ - 仅当前项目使用
- 适合项目特定的 skills
🌙 Q10: 如何查看 Skill 的详细内容?
方法 1: 访问 Skills 网站
https://skills.sh/<owner>/<repo>/<skill-name>
1
方法 2: 查看本地文件
cat ~/.claude/skills/<skill-name>/SKILL.md
1
🌙 快速参考
🌙 常用命令速查表
| 操作 | 命令 |
|---|---|
| 搜索 skills | npx skills find [query] |
| 安装 skill(全局) | npx skills add <package> -g -y |
| 列出已安装 | npx skills ls -g |
| 删除 skill | npx skills remove <name> -g |
| 检查更新 | npx skills check |
| 更新所有 | npx skills update |
| 交互式删除 | npx skills remove -g |
| 查看帮助 | npx skills --help |
🌙 推荐资源
- Skills 官网: https://skills.sh/
- Skills map: https://skillsmp.com/
- GitHub 组织: https://github.com/vercel-labs/agent-skills
- 社区 Skills: https://github.com/topics/agent-skills
- 文档: https://github.com/anthropics/claude-code
🌙 下一步
🌙 初学者
- 安装 3-5 个核心 skills
- 尝试使用 Claude Code 完成任务
- 观察 skills 如何改进代码质量
🌙 进阶使用
- 探索更多专业领域的 skills
- 定期更新 skills
- 根据项目需求动态安装/删除
🌙 高级用户
- 创建自定义 skills
- 贡献到社区
- 优化 skills 配置
开始你的 Skills 之旅!
# 从这里开始
npx skills find
# 安装你的第一个 skill
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y
# 查看已安装的
npx skills ls -g
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8