HoRain云--Skills 基本结构

HoRain 云小助手个人主页⛺️生活的理想就是为了理想的生活!⛳️ 推荐前些天发现了一个超棒的服务器购买网站性价比超高大内存超划算忍不住分享一下给大家。点击跳转到网站。目录⛳️ 推荐Skill 的核心结构Frontmatter两个必填字段Markdown 正文执行说明的内部结构SKILL.md 实例Skill 的文件目录结构Skills 的核心本质是给 AI 制定标准化执行流程的操作指引规则一经编写完成就能像程序函数一样被反复调用、直接复用。Skills 以 Markdown 文本载体存储本身不直接执行功能。Skills 按需加载、渐进式调用的特性高效沉淀工作经验实现能力快速复用与精准传递。Skill 的核心结构Skills 的核心就是一个文件夹 一个 SKILL.md 文件。SKILL.md 文件包含元数据至少要有名称和描述告诉 AI 如何完成某一特定任务的指令一个 Skill 本质上就是一个 Markdown 文件文件名固定为 SKILL.mdmy-skill/ └── SKILL.md 唯一必需SKILL.md 基本模板:--- name: your-skill-name description: Brief description of what this Skill does and when to use it --- # Your Skill Name ## Instructions [Clear, step-by-step guidance for Claude to follow] ## Examples [Concrete examples of using this Skill]整个 SKILL.md 分为上下两部分用 --- 包裹的 YAML frontmatter头部配置以及下方的 Markdown 正文执行说明。接下来我们逐一拆解每个部分:Frontmatter两个必填字段Frontmatter 是 SKILL.md 顶部用 --- 包裹的 YAML 配置块是整个 Skill 的身份信息。官方只规定两个必填字段字段一name技能名称name 字段最多 64 个字符只能包含小写字母、数字和连字符。name: processing-pdfs # 好动名词形式清晰描述功能 name: analyzing-spreadsheets # 好一眼知道用途 name: my-brand-guidelines # 好组织专属知识 name: helper # 差太模糊 name: MySkill # 差包含大写字母不合规 name: data files # 差包含空格不合规推荐使用动名词形式动词 -ing来命名如 processing-pdfs、analyzing-spreadsheets这样能清晰描述 Skill 提供的活动或能力。字段二description触发条件描述这是最重要的字段。启动时系统只会把所有 Skills 的 name 和 description 预加载进系统提示词。只有当 description 被 AI 判断与当前任务相关时才会进一步读取完整的 SKILL.md 内容。description 应该同时包含两部分这个 Skill 做什么以及什么时候 Claude 应该使用它。description: | Use when the user needs to create, read, edit, or generate Word documents (.docx). Triggers include: Word doc, word document, .docx, report, letter, memo, or any request to produce a formatted document for sharing or printing.Markdown 正文执行说明的内部结构Frontmatter 之后是 Markdown 正文告诉 AI 具体怎么做。至少包含两个区块SKILL.md 实例SKILL.md 基本模板:--- name: pdf-processing description: 从 PDF 中提取文本和表格填写表单并合并文档 --- # PDF 处理 ## 使用场景 当需要对 PDF 文件进行操作时使用例如 - 提取 PDF 文本或表格数据 - 填写 PDF 表单 - 合并多个 PDF 文件 ## 提取文本 - 使用 pdfplumber 提取文本型 PDF 内容 - 扫描版 PDF 需配合 OCR 工具 ## 填写表单 - 读取 PDF 表单字段 - 按输入数据填充并生成新文件最小必填示例:--- name: skill-name description: 说明该 Skill 的功能以及适用场景 ---含可选字段示例:--- name: pdf-processing description: 从 PDF 中提取文本和表格填写表单并合并文档 license: Apache-2.0 metadata: author: example-org version: 1.0 ---字段说明字段必需说明name是Skill 名称最长 64 字符只能使用小写字母、数字和-且不能以-开头或结尾description是功能与使用场景说明最长 1024 字符不能为空license否许可证名称或指向随 Skill 附带的许可证文件compatibility否环境与依赖说明产品、系统包、网络权限等最长 500 字符metadata否自定义键值对用于扩展元数据如作者、版本号allowed-tools否允许使用的工具列表空格分隔实验性功能Skill 的文件目录结构一个技能就是一个文件夹至少包含一个 SKILL.md 文件根据需要还可以包含其他目录和文件。为避免上下文膨胀核心规则 →SKILL.md详细资料 → 单独文件实用逻辑 → 脚本执行不加载推荐结构:my-skill/ ├── SKILL.md # 必需元数据 指令 ├── scripts/ # 可选可执行代码 └── helper.py ├── references/ # 可选参考文档 ├── assets/ # 可选模板、资源 └── ... # 其他文件或目录各目录的作用如下SKILL.md必需文件包含技能的元数据和执行指令scripts/可选目录包含代理可以执行的可执行代码references/可选目录包含详细的参考资料assets/可选目录包含静态资源如模板、图片等❤️❤️❤️本人水平有限如有纰漏欢迎各位大佬评论批评指正如果觉得这篇文对你有帮助的话也请给个点赞、收藏下吧非常感谢! Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧