Claude Code Skills 国内实践全指南:从安装部署到高阶开发

Claude Code 的本质不是一个聊天机器人,而是一个 “可装备技能”的AI智能体。核心转变在于:从反复撰写提示词的“人适应机器”,转变为通过标准化技能模块“让机器具备确定性的专业能力”。
如果说基础功能是“汽车”,那么Skills就是让这辆车具备越野、漂移、载货等特种能力的“改装套件”。它通过标准化文件(一个文件夹+SKILL.md+资源)封装复杂工作流,实现能力复用。
一、Claude Code Skills 生态资源
1,官方教材库:官方技能
#Anthropic官方Skills库:https://github.com/anthropics/skills
#Skills 官方介绍(What are Skills):https://support.claude.com/en/articles/12512176-what-are-skills#Claude Code Skills 文档:https://code.claude.com/docs/en/skills#Claude API Skills 指南:https://platform.claude.com/docs/en/build-with-claude/skills-guide#Skill Creator:https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md#Agent Skills 背景/机制:https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills

#OpenAI:Codex Skills(规则与目录结构)

#Skills 总览:https://developers.openai.com/codex/skills/#创建自定义 Skills:https://developers.openai.com/codex/skills/create-skill/#ChatGPT 环境的 /home/oai/skills(社区实测打包仓)https://github.com/eliasjudin/oai-skills

2,社区精选集:寻找现成技能
#obra/superpowers 
https://github.com/obra/superpowers#skills目录https://github.com/obra/superpowers/tree/main/skills

#ComposioHQ/awesome-claude-skills:生态集成导向(更新活跃,社区关注度高,强烈推荐)

由AI工具集成平台Composio维护,强调查找可直接用于生产、能与其他工具链集成的实战型技能。

通常按应用场景(如开发、数据分析、内容创作)或集成平台分类,便于寻找开箱即用的方案。

https://github.com/ComposioHQ/awesome-claude-skills

#VoltAgent/awesome-claude-skills:社区热度导向

注重收录近期流行、受关注度高、有创新性的技能,是追踪社区趋势的风向标。

https://github.com/VoltAgent/awesome-claude-skills
#travisvn/awesome-claude-skills:综合资源导航

提供一个覆盖面广、分类清晰的综合性资源索引,类似传统的“Awesome List”。资源导航分类比较经典和全面,旨在覆盖Skill生态的各个方面,方便系统性浏览。

https://github.com/travisvn/awesome-claude-skills

#BehiSecc/awesome-claude-skills:垂直领域导向

侧重安全(Security)相关或“生产就绪”的模板,内容领域性较强。分类会围绕特定领域(如安全审计、代码加固、合规检查)展开,深度大于广度。

https://github.com/BehiSecc/awesome-claude-skills


3,聚合市场 :开箱即用
#SkillsMP:可搜索 Skills 目录(分类/检索)
https://skillsmp.com/

#ClaudeMarketplaces:marketplace/插件目录

https://claudemarketplaces.com/

#Claude Code Templates:模板与偏工程化配置集合、命令集

https://www.aitmpl.com/skillshttps://github.com/davila7/claude-code-templates
#ruvnet/claude-flow

企业级智能体集群编排平台,内置 25个 自然语言触发的技能,侧重于开发、GitHub、集群协调等

https://github.com/ruvnet/claude-flow

#wshobson/agents

精细化的插件化智能体市场,提供67个专注于Claude代码的专业化技能,涵盖开发、运维、AI、安全等多个类别

https://github.com/wshobson/agents

二、Claude Code Skill安装/部署
1,通过聚合市场网站(推荐)
以 SkillsMP 为例,在网站搜索、分类查找技能。
点击技能查看详情和安装命令
/plugin marketplace add 作者/仓库名
/plugin marketplace add wshobson/agents
复制后,在Claude Code会话中直接粘贴该命令即可完成安装。

2,通过插件市场命令安装
进入到项目GitHub主页,通过技能所在的GitHub仓库(如wshobson/agents)安装
第一步:在Claude Code中输入命令添加整个市场
/plugin marketplace add wshobson/agents

第二步:安装具体插件
/plugin install sql-optimization-patterns
注意:此处由于技术市场新版本移除了某skill技能,可下载该skill.md文件,通过手动安装方式进行安装(参考下节)

3,手动安装(高级用户,自定义技能)
自己开发或从GitHub仓库直接下载的单个技能(.md文件):
将技能文件(如 code-reviewer.SKILL.md)放置到本地技能目录:(可根据系统调整路径)。
~/.claude/skills/
重启Claude Code即可生效

第一步:下载sql-optimization-patterns技能文件,
blob:https://skillsmp.com/1dfeae32-c71d-4740-bab6-26f46b848134
第二步:解压后放到claude本地技能目录下(需重启claude)
第三步:重启claude后,输入 /context 命令查看,安装成功

三,Claude Code Skill完整操作流程
# 启动claude
claude
# 查看skill
/plugin
# 按键盘方向键切换tab,可查看当前已安装的技能、技能市场
#查看当前已安装的技能市场(当前仅默认的官方技能市场)
#安装wshobson/agents技能市场
方式1:直接输入
/plugin marketplace add wshobson/agents
方式2:方向键切换到Marketplace,选择Add Marketplace
然后输入 wshobson/agents
说明:如果网络问题,可以提前下载到本地,此处使用本地文件路径

#技能市场的技能浏览、更新、卸载


# 安装本地技能市场
#克隆skill项目到本地git clone https://github.com/davila7/claude-code-templates.git
#搜索插件安装(以  code-review 为例)
四、高阶进阶:开发自己的专属技能
开发技能的本质,是将你的经验转化为可复用的数字资产。一个高质量Skill的关键在于结构清晰、可执行、可验收。

----SKILL开发“产品思维----

一个优秀的SKILL不是一段对话提示,而是一个迷你产品。SKILL的KPI只有一个:可以一次跑通并验收结果。

1,编写 技能文件 (SKILL.md) 完整 

以一个生产级可用的“API接口生成器”技能的SKILL.md 示例

#SKILL.md

---name: api-interface-generatordescription: 根据后端Controller代码,自动生成前端TypeScript接口定义与Axios请求函数。version: 1.0.0author: your-nametags:  - typescript  - api  - code-generation---# Goal- **输出物**:一个标准的TypeScript文件(`api.ts`),包含:  1.  所有接口的请求/响应类型定义(TypeScript Interfaces)。  2.  对应每个接口的、已配置基础的Axios请求函数。- **可验证**:生成的代码应能通过TypeScript编译(`tsc --noEmit`检查)。# Inputs- **必填**:  1.  `controller_path`: 后端Controller源代码的文件路径或直接粘贴的代码。  2.  `api_base_url`: 后端API的基础URL(例如:`https://api.example.com/v1`)。- **可选**:  1.  `auth_type`: 认证方式,默认为 `'bearer'`(可选:`basic`, `none`)。# Constraints- **不做什么**:  - 不修改任何后端源代码。  - 不生成除TypeScript类型和请求函数之外的任何框架特定代码(如React Hooks)。- **质量与边界**:  - 所有生成的函数必须包含完整的JSDo…
— 以上为试看内容(约 40%),开通会员后阅读全文 —