suggest-awesome-github-copilot-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Suggest Awesome GitHub Copilot Skills

推荐实用的GitHub Copilot技能

Analyze current repository context and suggest relevant Agent Skills from the GitHub awesome-copilot repository that are not already available in this repository. Agent Skills are self-contained folders located in the skills folder of the awesome-copilot repository, each containing a

SKILL.md

file with instructions and optional bundled assets.

分析当前仓库上下文，从GitHub awesome-copilot仓库中推荐本仓库尚未具备的相关Agent Skills。Agent Skills是独立的文件夹，位于awesome-copilot仓库的skills目录下，每个文件夹都包含一个

SKILL.md

文件，里面有使用说明和可选的配套资源。

Process

流程

Fetch Available Skills: Extract skills list and descriptions from awesome-copilot README.skills.md. Must use
```
#fetch
```
tool.
Scan Local Skills: Discover existing skill folders in
```
.github/skills/
```
folder
Extract Descriptions: Read front matter from local
```
SKILL.md
```
files to get
```
name
```
and
```
description
```
Fetch Remote Versions: For each local skill, fetch the corresponding
```
SKILL.md
```
from awesome-copilot repository using raw GitHub URLs (e.g.,
```
https://raw.githubusercontent.com/github/awesome-copilot/main/skills/<skill-name>/SKILL.md
```
)
Compare Versions: Compare local skill content with remote versions to identify:
- Skills that are up-to-date (exact match)
- Skills that are outdated (content differs)
- Key differences in outdated skills (description, instructions, bundled assets)
Analyze Context: Review chat history, repository files, and current project needs
Compare Existing: Check against skills already available in this repository
Match Relevance: Compare available skills against identified patterns and requirements
Present Options: Display relevant skills with descriptions, rationale, and availability status including outdated skills
Validate: Ensure suggested skills would add value not already covered by existing skills
Output: Provide structured table with suggestions, descriptions, and links to both awesome-copilot skills and similar local skills AWAIT user request to proceed with installation or updates of specific skills. DO NOT INSTALL OR UPDATE UNLESS DIRECTED TO DO SO.
Download/Update Assets: For requested skills, automatically:
- Download new skills to
```
.github/skills/
```
  folder, preserving the folder structure
- Update outdated skills by replacing with latest version from awesome-copilot
- Download both
```
SKILL.md
```
  and any bundled assets (scripts, templates, data files)
- Do NOT adjust content of the files
- Use
```
#fetch
```
  tool to download assets, but may use
```
curl
```
  using
```
#runInTerminal
```
  tool to ensure all content is retrieved
- Use
```
#todos
```
  tool to track progress

获取可用技能：从awesome-copilot的README.skills.md中提取技能列表和描述。必须使用
```
#fetch
```
工具。
扫描本地技能：发现
```
.github/skills/
```
目录下已有的技能文件夹
提取描述信息：读取本地
```
SKILL.md
```
文件的前置元数据，获取
```
name
```
和
```
description
```
字段
获取远程版本：对于每个本地技能，通过GitHub原始URL获取awesome-copilot仓库中对应的
```
SKILL.md
```
文件（例如：
```
https://raw.githubusercontent.com/github/awesome-copilot/main/skills/<skill-name>/SKILL.md
```
）
版本对比：对比本地技能内容与远程版本，识别：
- 已更新至最新版本的技能（内容完全匹配）
- 过时的技能（内容存在差异）
- 过时技能的核心差异点（描述、说明、配套资源）
上下文分析：查看聊天历史、仓库文件和当前项目需求
对比已有技能：检查与本仓库已安装技能的重复情况
匹配相关性：将可用技能与识别出的模式和需求进行匹配
展示选项：显示相关技能的描述、推荐理由和可用性状态（包括过时技能）
验证：确保推荐的技能能提供现有技能未覆盖的价值
输出：以结构化表格形式展示推荐内容，包含技能描述、推荐理由，以及指向awesome-copilot技能和相似本地技能的链接等待用户发起具体技能的安装或更新请求。除非收到明确指令，否则请勿执行安装或更新操作。
下载/更新资源：对于用户请求的技能，自动执行以下操作：
- 将新技能下载至
```
.github/skills/
```
  目录，保留原有文件夹结构
- 用awesome-copilot中的最新版本替换过时技能
- 下载
```
SKILL.md
```
  文件及所有配套资源（脚本、模板、数据文件）
- 请勿修改文件内容
- 使用
```
#fetch
```
  工具下载资源，也可通过
```
#runInTerminal
```
  工具执行
```
curl
```
  命令以确保获取全部内容
- 使用
```
#todos
```
  工具跟踪进度

Context Analysis Criteria

上下文分析标准

🔍 Repository Patterns:

Programming languages used (.cs, .js, .py, .ts, etc.)
Framework indicators (ASP.NET, React, Azure, Next.js, etc.)
Project types (web apps, APIs, libraries, tools, infrastructure)
Development workflow requirements (testing, CI/CD, deployment)
Infrastructure and cloud providers (Azure, AWS, GCP)

🗨️ Chat History Context:

Recent discussions and pain points
Feature requests or implementation needs
Code review patterns
Development workflow requirements
Specialized task needs (diagramming, evaluation, deployment)

🔍 仓库模式：

使用的编程语言（.cs、.js、.py、.ts等）
框架标识（ASP.NET、React、Azure、Next.js等）
项目类型（Web应用、API、库、工具、基础设施）
开发工作流需求（测试、CI/CD、部署）
基础设施与云服务商（Azure、AWS、GCP）

🗨️ 聊天历史上下文：

近期讨论的内容和痛点
功能请求或实现需求
代码审查模式
开发工作流需求
特殊任务需求（绘图、评估、部署）

Output Format

输出格式

Display analysis results in structured table comparing awesome-copilot skills with existing repository skills:

Awesome-Copilot Skill	Description	Bundled Assets	Already Installed	Similar Local Skill	Suggestion Rationale
gh-cli	GitHub CLI skill for managing repositories and workflows	None	❌ No	None	Would enhance GitHub workflow automation capabilities
aspire	Aspire skill for distributed application development	9 reference files	✅ Yes	aspire	Already covered by existing Aspire skill
terraform-azurerm-set-diff-analyzer	Analyze Terraform AzureRM provider changes	Reference files	⚠️ Outdated	terraform-azurerm-set-diff-analyzer	Instructions updated with new validation patterns - Update recommended

以结构化表格形式展示分析结果，对比awesome-copilot技能与本仓库现有技能：

Awesome-Copilot技能	描述	配套资源	是否已安装	相似本地技能	推荐理由
gh-cli	用于管理仓库和工作流的GitHub CLI技能	无	❌ 未安装	无	可增强GitHub工作流自动化能力
aspire	用于分布式应用开发的Aspire技能	9个参考文件	✅ 已安装	aspire	现有Aspire技能已覆盖该功能
terraform-azurerm-set-diff-analyzer	分析Terraform AzureRM提供商的变更	参考文件	⚠️ 已过时	terraform-azurerm-set-diff-analyzer	说明文档已更新新的验证模式 - 建议更新

Local Skills Discovery Process

本地技能发现流程

List all folders in
```
.github/skills/
```
directory
For each folder, read
```
SKILL.md
```
front matter to extract
```
name
```
and
```
description
```
List any bundled assets within each skill folder
Build comprehensive inventory of existing skills with their capabilities
Use this inventory to avoid suggesting duplicates

列出
```
.github/skills/
```
目录下的所有文件夹
对于每个文件夹，读取
```
SKILL.md
```
的前置元数据，提取
```
name
```
和
```
description
```
字段
列出每个技能文件夹中的配套资源
构建包含现有技能及其功能的完整清单
利用该清单避免推荐重复技能

Version Comparison Process

版本对比流程

For each local skill folder, construct the raw GitHub URL to fetch the remote

SKILL.md

Pattern:

https://raw.githubusercontent.com/github/awesome-copilot/main/skills/<skill-name>/SKILL.md

Fetch the remote version using the
```
#fetch
```
tool
Compare entire file content (including front matter and body)
Identify specific differences:
- Front matter changes (name, description)
- Instruction updates (guidelines, examples, best practices)
- Bundled asset changes (new, removed, or modified assets)
Document key differences for outdated skills
Calculate similarity to determine if update is needed

对于每个本地技能文件夹，构造获取远程

SKILL.md

的GitHub原始URL：

格式：

https://raw.githubusercontent.com/github/awesome-copilot/main/skills/<skill-name>/SKILL.md

使用
```
#fetch
```
工具获取远程版本
对比整个文件内容（包括前置元数据和正文）
识别具体差异：
- 前置元数据变更（名称、描述）
- 说明文档更新（指南、示例、最佳实践）
- 配套资源变更（新增、移除或修改的资源）
记录过时技能的核心差异点
计算相似度以确定是否需要更新

Skill Structure Requirements

技能结构要求

Based on the Agent Skills specification, each skill is a folder containing:

SKILL.md
: Main instruction file with front matter (
```
name
```
,
```
description
```
) and detailed instructions
Optional bundled assets: Scripts, templates, reference data, and other files referenced from
```
SKILL.md
```
Folder naming: Lowercase with hyphens (e.g.,
```
azure-deployment-preflight
```
)
Name matching: The
```
name
```
field in
```
SKILL.md
```
front matter must match the folder name

根据Agent Skills规范，每个技能是一个包含以下内容的文件夹：

SKILL.md
：主说明文件，包含前置元数据（
```
name
```
、
```
description
```
）和详细使用说明
可选配套资源：脚本、模板、参考数据以及
```
SKILL.md
```
中引用的其他文件
文件夹命名：小写字母，用连字符分隔（例如：
```
azure-deployment-preflight
```
）
名称匹配：
```
SKILL.md
```
前置元数据中的
```
name
```
字段必须与文件夹名称一致

Front Matter Structure

前置元数据结构

Skills in awesome-copilot use this front matter format in

SKILL.md

markdown

---
name: 'skill-name'
description: 'Brief description of what this skill provides and when to use it'
---

awesome-copilot中的技能在

SKILL.md

中使用以下前置元数据格式：

markdown

---
name: 'skill-name'
description: 'Brief description of what this skill provides and when to use it'
---

Requirements

要求

Use
```
fetch
```
tool to get content from awesome-copilot repository skills documentation
Use
```
githubRepo
```
tool to get individual skill content for download
Scan local file system for existing skills in
```
.github/skills/
```
directory
Read YAML front matter from local
```
SKILL.md
```
files to extract names and descriptions
Compare local skills with remote versions to detect outdated skills
Compare against existing skills in this repository to avoid duplicates
Focus on gaps in current skill library coverage
Validate that suggested skills align with repository's purpose and technology stack
Provide clear rationale for each suggestion
Include links to both awesome-copilot skills and similar local skills
Clearly identify outdated skills with specific differences noted
Consider bundled asset requirements and compatibility
Don't provide any additional information or context beyond the table and the analysis

使用
```
fetch
```
工具从awesome-copilot仓库的技能文档中获取内容
使用
```
githubRepo
```
工具获取单个技能的内容以进行下载
扫描本地文件系统，查找
```
.github/skills/
```
目录下的现有技能
读取本地
```
SKILL.md
```
文件的YAML前置元数据，提取名称和描述
对比本地技能与远程版本，检测过时技能
与本仓库现有技能对比，避免推荐重复内容
聚焦当前技能库的覆盖缺口
验证推荐的技能是否与仓库的用途和技术栈匹配
为每个推荐提供清晰的理由
包含指向awesome-copilot技能和相似本地技能的链接
明确标记过时技能并注明具体差异
考虑配套资源的需求和兼容性
除表格和分析内容外，请勿提供任何额外信息或上下文

Icons Reference

图标参考

✅ Already installed and up-to-date
⚠️ Installed but outdated (update available)
❌ Not installed in repo

✅ 已安装且为最新版本
⚠️ 已安装但已过时（有可用更新）
❌ 未在仓库中安装

Update Handling

更新处理

When outdated skills are identified:

Include them in the output table with ⚠️ status
Document specific differences in the "Suggestion Rationale" column
Provide recommendation to update with key changes noted
When user requests update, replace entire local skill folder with remote version
Preserve folder location in
```
.github/skills/
```
directory
Ensure all bundled assets are downloaded alongside the updated
```
SKILL.md
```

识别出过时技能后：

在输出表格中用⚠️标记其状态
在“推荐理由”列中记录具体差异
提供更新建议并注明核心变更点
当用户请求更新时，用远程版本替换整个本地技能文件夹
保留技能在
```
.github/skills/
```
目录中的位置
确保所有配套资源与更新后的
```
SKILL.md
```
一同下载