SuperAPI AI 工具集

skill-creation-guide

智能体与模型

查看项目

更新于 10-15 21:53

技能介绍

用途:该技能用于指导创建新的 Agent Skills,帮助理解 SKILL.md 的格式与约定,并学习技能编写的最佳实践。

主要能力:说明技能的标准目录结构,包含必需的 SKILL.md,以及可选的 scripts/、templates/、resources/ 目录;给出 SKILL.md 的必需 frontmatter(name、description)与正文结构(技能名称、用途说明、何时使用、指令、示例);总结最佳实践,如描述要详尽以便智能体判断触发时机、正文聚焦可执行步骤、用渐进式披露把详细参考放入 references/ 目录、用脚本处理确定性操作、SKILL.md 控制在 500 行以内、跨平台测试。

使用方式:按资料给出的目录与格式组织技能文件,并在对应平台的项目或全局路径下放置技能。资料列出的路径包括: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/。

适用场景:创建新技能、理解 SKILL.md 格式与约定、学习技能编写规范时使用。

限制与说明:资料提到技能采用渐进式披露架构,元数据加载约 100 tokens,完整指令少于 5k tokens,捆绑资源按需加载;并给出质量检查清单(指令清晰可执行、含真实示例、面向 AI 智能体而非终端用户、记录前置条件与依赖、包含错误处理指引、在目标平台测试)。更详细的资源列表需通过 WebFetch 获取 README.md:https://raw.githubusercontent.com/gmh5225/awesome-skills/refs/heads/main/README.md。其余细节暂未提供。