mcpField
S
skill-creation-guide

skill-creation-guide

github.com/gmh5225Agent 工作流9740 次安装5 天前更新
代码仓库

关于 skill-creation-guide

用于创建 Agent 技能的指南，介绍 SKILL.md 结构、编写方法、Token 效率和各平台路径，适合需要格式参考与质量检查清单的技能作者。

主要功能

  1. 01SKILL.md 结构与前置元数据
  2. 02编写及渐进式披露建议
  3. 03Token 效率说明
  4. 04各平台的技能路径
  5. 05质量检查清单

适用场景

  1. 01开始创建 Agent 技能
  2. 02核对 SKILL.md 必需元数据
  3. 03按平台选择技能安装路径
  4. 04依据编写标准检查技能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gmh5225/awesome-skills --skill skill-creation-guide

安装后在 Claude Code 中输入/skill-creation-guide确认已加载。

详细介绍

技能创建指南

范围

在以下情况下使用此技能：

  • 创建新的 Agent 技能
  • 了解 SKILL.md 格式和约定
  • 学习技能编写的最佳实践

技能结构

skill-name/
├── SKILL.md          # Required: Instructions and metadata
├── scripts/          # Optional: Helper scripts
├── templates/        # Optional: Document templates
└── resources/        # Optional: Reference files

SKILL.md 格式

必需的 Frontmatter
---
name: my-skill-name
description: A clear description of what this skill does and when to use it.
---
正文结构
# Skill Name

Detailed description of the skill's purpose.

## When to Use This Skill

- Use case 1
- Use case 2

## Instructions

[Detailed instructions for the agent]

## Examples

[Real-world examples]

最佳实践

  1. 保持描述全面：Frontmatter 中的描述有助于 Agent 判断何时触发技能。
  2. 专注于执行：正文应包含清晰、可操作的步骤。
  3. 采用渐进式披露：将详细参考资料放在 references/ 文件夹中。
  4. 加入自动化脚本：使用辅助脚本执行确定性操作。
  5. 将 SKILL.md 控制在 500 行以内：以获得最佳性能。
  6. 跨平台测试：验证技能能否在 Claude Code、Codex 等平台上运行。

令牌效率

技能采用渐进式披露架构：

  1. 元数据加载（约 100 个令牌）：Agent 扫描可用技能
  2. 完整说明（<5k 个令牌）：在技能激活时加载
  3. 捆绑资源：仅在需要时加载

特定平台的路径

平台项目路径全局路径
Claude Code.claude/skills/~/.claude/skills/
Codex.codex/skills/~/.codex/skills/
Cursor.cursor/skills/~/.cursor/skills/
Gemini CLI.gemini/skills/~/.gemini/skills/
GitHub Copilot.github/skills/~/.copilot/skills/

质量检查清单

  • 指令清晰且可操作
  • 包含真实示例
  • 面向 AI Agent，而非最终用户
  • 记录前置条件和依赖项
  • 包含错误处理指南
  • 已在目标平台上测试

完整资源列表

如需更详细的技能创建资源、完整链接列表或最新信息，请使用 WebFetch 获取完整的 README.md：

https://raw.githubusercontent.com/gmh5225/awesome-skills/refs/heads/main/README.md

README.md 包含完整的分类资源列表及所有链接。

评论

支持 Markdown