make-skill-template by github/awesome-copilot
npx skills add https://github.com/github/awesome-copilot --skill make-skill-template包含必需 YAML 前置元数据(name、description)和可选元数据字段的文件,用于技能发现
SKILL.md
一个用于创建新 Agent Skills 的元技能。当您需要搭建新技能文件夹、生成 SKILL.md 文件或帮助用户理解 Agent Skills 规范时,请使用此技能。
创建一个新的文件夹,使用小写、连字符分隔的名称:
skills/<技能名称>/
└── SKILL.md # 必需
每个技能都需要包含 name 和 description 的 YAML 前置元数据:
---
name: <技能名称>
description: '<它做什么>. 当<用户可能提及的具体触发条件、场景、关键词>时使用。'
---
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 字段 | 必需 | 约束 |
|---|---|---|
name | 是 | 1-64 个字符,仅限小写字母/数字/连字符,必须与文件夹名称匹配 |
description | 是 | 1-1024 个字符,必须描述它做什么以及何时使用它 |
license | 否 | 许可证名称或对捆绑的 LICENSE.txt 的引用 |
compatibility | 否 | 1-500 个字符,如有需要则说明环境要求 |
metadata | 否 | 用于附加属性的键值对 |
allowed-tools | 否 | 预批准工具的以空格分隔的列表(实验性) |
关键:description 是自动技能发现的主要机制。请包含:
良好示例:
description: '使用 Playwright 测试本地 Web 应用程序的工具包。当被要求验证前端功能、调试 UI 行为、捕获浏览器截图或查看浏览器控制台日志时使用。支持 Chrome、Firefox 和 WebKit。'
不佳示例:
description: 'Web 测试助手'
在前置元数据之后,添加 Markdown 说明。推荐包含以下部分:
| 部分 | 目的 |
|---|---|
# 标题 | 简要概述 |
## 何时使用此技能 | 强化描述中的触发条件 |
## 先决条件 | 必需的工具、依赖项 |
## 分步工作流程 | 任务的分步说明 |
## 故障排除 | 常见问题及解决方案 |
## 参考资料 | 指向捆绑文档的链接 |
| 文件夹 | 目的 | 何时使用 |
|---|---|---|
scripts/ | 可执行代码(Python、Bash、JS) | 执行操作的自动化脚本 |
references/ | 代理读取的文档 | API 参考、模式、指南 |
assets/ | 按原样使用的静态文件 | 图像、字体、模板 |
templates/ | 代理修改的起始代码 | 用于扩展的脚手架 |
my-awesome-skill/
├── SKILL.md # 必需的说明
├── LICENSE.txt # 可选的许可证文件
├── scripts/
│ └── helper.py # 可执行的自动化脚本
├── references/
│ ├── api-reference.md # 详细文档
│ └── examples.md # 使用示例
├── assets/
│ └── diagram.png # 静态资源
└── templates/
└── starter.ts # 代码脚手架
make-skill-template/ 文件夹SKILL.md:
name: 更改为与文件夹名称匹配description:npm run skill:validate 进行验证name 字段与文件夹名称完全匹配description 为 10-1024 个字符description 解释了做什么和何时使用description 用单引号包裹| 问题 | 解决方案 |
|---|---|
| 技能未被发现 | 在描述中添加更多关键词和触发条件 |
| 名称验证失败 | 确保为小写、无连续连字符、与文件夹匹配 |
| 描述太短 | 添加功能、触发条件和关键词 |
| 资产未找到 | 使用从技能根目录开始的相对路径 |
每周安装量
7.7K
代码仓库
GitHub 星标数
26.7K
首次出现时间
2026 年 1 月 20 日
安全审计
安装于
opencode7.5K
github-copilot7.5K
codex7.5K
gemini-cli7.5K
kimi-cli7.4K
cursor7.4K
files with required YAML frontmatter (name, description) and optional metadata fields for skill discovery
SKILL.md
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.
Create a new folder with a lowercase, hyphenated name:
skills/<skill-name>/
└── SKILL.md # Required
Every skill requires YAML frontmatter with name and description:
---
name: <skill-name>
description: '<What it does>. Use when <specific triggers, scenarios, keywords users might say>.'
---
| 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 |
metadata |
CRITICAL : The description is the PRIMARY mechanism for automatic skill discovery. Include:
Good example:
description: 'Toolkit for testing local web applications using Playwright. Use when asked to verify frontend functionality, debug UI behavior, capture browser screenshots, or view browser console logs. Supports Chrome, Firefox, and WebKit.'
Poor example:
description: 'Web testing helpers'
After the frontmatter, add markdown instructions. Recommended sections:
| Section | Purpose |
|---|---|
# Title | Brief overview |
## When to Use This Skill | Reinforces description triggers |
## Prerequisites | Required tools, dependencies |
## Step-by-Step Workflows | Numbered steps for tasks |
## Troubleshooting | Common issues and solutions |
## References |
| Folder | Purpose | When to Use |
|---|---|---|
scripts/ | Executable code (Python, Bash, JS) | Automation that performs operations |
references/ | Documentation agent reads | API references, schemas, guides |
assets/ | Static files used AS-IS | Images, fonts, templates |
templates/ | Starter code agent modifies | Scaffolds to extend |
my-awesome-skill/
├── SKILL.md # Required instructions
├── LICENSE.txt # Optional license file
├── scripts/
│ └── helper.py # Executable automation
├── references/
│ ├── api-reference.md # Detailed docs
│ └── examples.md # Usage examples
├── assets/
│ └── diagram.png # Static resources
└── templates/
└── starter.ts # Code scaffold
make-skill-template/ folderSKILL.md:
name: to match folder namedescription:npm run skill:validatename field matches folder name exactlydescription is 10-1024 charactersdescription explains WHAT and WHENdescription is wrapped in single quotes| Issue | Solution |
|---|---|
| Skill not discovered | Improve description with more keywords and triggers |
| Validation fails on name | Ensure lowercase, no consecutive hyphens, matches folder |
| Description too short | Add capabilities, triggers, and keywords |
| Assets not found | Use relative paths from skill root |
Weekly Installs
7.7K
Repository
GitHub Stars
26.7K
First Seen
Jan 20, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode7.5K
github-copilot7.5K
codex7.5K
gemini-cli7.5K
kimi-cli7.4K
cursor7.4K
97,600 周安装
| No |
| Key-value pairs for additional properties |
allowed-tools | No | Space-delimited list of pre-approved tools (experimental) |
| Links to bundled docs |