1、什么是agent-skills

什么是agent-skills：就是告诉智能体 “你会什么技能”，再把提示词、参考文档、工具调用这些零散的能力给它封装起来，同时定好一套固定的执行流程和方式。这样，智能体每次调用技能，都能输出一致、可靠、可控的结果，而且这些技能还可以被反复利用。

2、agent-skills工程结构

标准 Agent-Skills 工程结构:

my-awesome-skill/
  ├── SKILL.md          # 核心文件：技能定义、流程规则
  ├── references/       # 经验配方：参考资料、模板、标准
  ├── scripts/          # 所需工具：可执行脚本、工具调用逻辑
  └── assets/           # 其他材料：模板文件、静态资源

1、SKILL.md：这是技能的 “说明书”，定义了技能的元信息和完整执行流程。
2、references/（经验配方）：存放技能所需的参考资料、标准模板、经验规则。
3、scripts/（所需工具）：存放技能调用的可执行脚本、工具封装。
4、assets/（其他材料）：存放静态资源、模板文件、样式表等辅助材料。

举例：厨师技能工程结构

工程文件 / 目录	对应厨师技能部分	作用
SKILL.md	做菜流程规则	定义 “先炒蛋后炒番茄” 的步骤与约束
references/	经验配方	存放盐 / 糖 / 油温的参数、口味标准
scripts/	菜刀、砧板	可执行的工具脚本，处理具体任务
assets/	好看的盘子、装饰	输出结果的模板、样式资源

---

3.1、使用frontend-design skill生成网页

1、安装claude-code、配置国内模型（https://blog.csdn.net/qq_46921028/article/details/160429227）

2、下载skill

git clone https://github.com/anthropics/skills.git

3、使用skill

在我们的项目结构中创建一个.claude文件夹（claude启动时会自动识别），然后在.claude下面创建一个skills文件夹，用于存放所有 Skill 相关内容。

整体项目结构目录如下：

project-base/                # 项目根目录
├── .claude/              # 平台配置目录（与opencode的.opencodes目录对应）
└── skills/                  # 技能总目录，存放所有自定义技能
    ├── skill-name-alpha/    # 具体技能目录（示例1）
    │   ├── SKILL.md         # 技能核心定义文件（必填，流程规则+元信息）
    │   ├── references/      # 经验配方目录（可选，存放参考资料、模板、标准）
    │   ├── scripts/         # 工具脚本目录（可选，存放可执行工具、处理脚本）
    │   └── assets/          # 静态资源目录（可选，存放模板、样式、素材文件）
    └── skill-name-beta/     # 具体技能目录（示例2）
        └── SKILL.md         # 技能核心定义文件

在当前项目路径下打开终端触发claude：

提问：我想设计一个公路车科普的网站首页，页面要高端大气上档次，配图要好看，不确定的地方要跟我确认

index.html

4、skill开发规则

官方：https://agentskills.io/specification

电子书下载：https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf?hsLang=en The-Complete-Guide-to-Building-Skill-for-Claude.pdf

1、skill工程至少包含一个SKILL.md，其它都是可选的，目录结构如下：

kill-name/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates, resources
└── ...               # Any additional files or directories

2、SKILL.md 文件，包含yaml前置元数据和后面具体的markdown内容。

第一部分：前置元数据

---
name: skill名称
description: skill描述，你这个skill是干嘛的，处理什么工作，处理什么任务的，agent会根据当前的描述判断用户发出的指令需不需要走这个skill
---

第二部分：markdown正文（也就是skill说明，格式不限，只需编写能帮助代理人高效完成任务的相关内容即可）

你这个技能要完成什么事
步骤是什么
规则是什么
流程是什么
中间需要用到什么 用到什么去哪找它

示例代码：https://gitee.com/aopmin/aopmin-skills/tree/main/weather-skill