创建技能模板

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install make-skill-template
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 make-skill-template。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

创建技能模板是一款用于为 GitHub Copilot 创建新智能体技能的元技能。它会引导你创建技能目录、编写带有 YAML frontmatter 的有效 SKILL.md，并将说明整理到实用的章节中。它提供的指导有助于技能说明自身的功能，以及智能体应在何时使用它。
使用此 Openclaw Skills 资源从头创建技能，或根据特定能力调整模板。如果技能需要辅助材料，可以添加可选脚本、参考资料、资源文件和入门模板；然后使用仓库的 npm run skill:validate 命令验证结果。

应用场景

根据提示创建或搭建新的 GitHub Copilot 智能体技能。
为现有 Copilot 配置添加专门能力。
改进技能名称和描述，让智能体能在相关触发条件下发现它。
整理包含脚本、参考文档、静态资源或可编辑入门模板的技能。
复制此模板，作为新技能的基础。
查看智能体技能规范，并检查常见的结构或验证问题。

工作原理

确定技能预期提供的能力、使用场景、触发短语，以及所需的捆绑资源。
使用小写字母、数字和连字符创建 skills// 目录。
添加必需的 SKILL.md，其中的 YAML frontmatter 应包含匹配的 name，以及关于技能功能和使用时机的描述。
使用 Markdown 编写技能正文，并添加相关章节，例如先决条件、分步工作流程、故障排除和参考资料。
添加可选的 scripts/、references/、assets/ 或 templates/ 目录以支持相应能力。
运行仓库的验证命令，并解决命名、描述内容、文件路径或资源大小限制方面的问题。

配置指南

在 skills/ 下创建一个由小写字母和连字符组成的技能文件夹，并添加 SKILL.md。
填写 YAML frontmatter。name 必须为 1–64 个字符，并与文件夹名称匹配；description 必须为 1–1024 个字符，说明技能能力及其触发条件。模板的验证清单建议描述长度为 10–1024 个字符。
编写 Markdown 说明，并仅在需要时添加可选资源文件夹。
在仓库根目录验证技能：
npm run skill:validate
要复制模板，请复制其文件夹、重命名文件夹、更新 frontmatter 和正文、添加所需资源，然后运行相同的验证命令。按照模板清单的规定，正文应少于 500 行，每个捆绑资源文件应小于 5 MB。

数据架构

技能以目录形式组织，其名称必须与必需的 SKILL.md frontmatter 中的 name 值相匹配。
文件或目录 要求 用途
SKILL.md 必需 为智能体提供 YAML 元数据和 Markdown 说明。
name 必需的 frontmatter 字段 技能标识符；长度为 1–64 个字符，只能使用小写字母、数字或连字符，并且必须与文件夹名称匹配。
description 必需的 frontmatter 字段 用于发现技能的元数据，说明技能功能及使用时机；长度为 1–1024 个字符。
license 可选的 frontmatter 字段 许可证名称或对捆绑的 LICENSE.txt 的引用。
compatibility 可选的 frontmatter 字段 环境要求，最多 500 个字符。
metadata 可选的 frontmatter 字段 其他键值属性。
allowed-tools 可选的实验性字段 以空格分隔的预先批准工具列表。
scripts/ 可选 可执行自动化脚本，例如 Python、Bash 或 JavaScript。
references/ 可选 提供给智能体的文档，包括 API 参考资料和指南。
assets/ 可选 按原样使用的静态资源，例如图片、字体或模板。
templates/ 可选 智能体可以修改的入门代码。
建议的正文结构包括概述、使用触发条件、先决条件、工作流程、故障排除和参考资料。捆绑资源请使用相对于技能根目录的路径。

高级特性

面向发现的描述：加入能力、用户触发条件、场景、相关文件类型和可能出现在提示中的关键词，以便恰当地选择技能。
模块化资源捆绑：将可执行自动化脚本、智能体可读文档、静态文件和可修改的入门代码分别放入专用目录。
可选元数据控制：在 frontmatter 中指定兼容性要求、其他元数据、许可证或实验性预先批准工具。
可复用的模板工作流程：复制模板，为多个专用技能建立一致的基础。
验证检查：使用仓库验证命令检查命名、frontmatter、描述质量、正文长度和捆绑资源大小。

name: make-skill-template description: 'Create new Agent Skills for GitHub Copilot from prompts or by duplicating this template. Use when asked to "create a skill", "make a new skill", "scaffold a skill", or when building specialized AI capabilities with bundled resources. Generates SKILL.md files with proper frontmatter, directory structure, and optional scripts/references/assets folders.'

Make Skill Template

A meta-skill for creating new Agent Skills. Use this skill when you need to scaffold a new skill folder, generate a SKILL.md file, or help users understand the Agent Skills specification.

When to Use This Skill

User asks to "create a skill", "make a new skill", or "scaffold a skill"
User wants to add a specialized capability to their GitHub Copilot setup

User needs help structuring a skill with bundled resources

User wants to duplicate this template as a starting point

Prerequisites

Understanding of what the skill should accomplish

A clear, keyword-rich description of capabilities and triggers
Knowledge of any bundled resources needed (scripts, references, assets, templates)

Creating a New Skill

Step 1: Create the Skill Directory

Create a new folder with a lowercase, hyphenated name:

skills//
└── SKILL.md # Required

Step 2: Generate SKILL.md with Frontmatter

Every skill requires YAML frontmatter with name and description:

name:
description: '. Use when .'

Frontmatter Field Requirements

Field Required Constraints

name Yes 1-64 chars, lowercase letters/numbers/hyphens only, must match folder name
description Yes 1-1024 chars, must describe WHAT it does AND WHEN to use it
license No License name or reference to bundled LICENSE.txt
compatibility No 1-500 chars, environment requirements if needed