SuperAPI AI 工具集

creating-agent-skills

智能体与模型

查看项目

更新于 10-15 21:39

技能介绍

用途:该技能教授如何按照 Anthropic 官方规范创建有效的 Claude Code Skills,适用于编写 SKILL.md、创建新技能、审计或改进现有技能。

主要能力与原则:技能本质是提示词,需清晰直接;采用 YAML frontmatter 加 markdown 正文,不使用 XML 标签;渐进式披露,SKILL.md 保持在 500 行以内,详细内容拆分到引用文件;description 字段用于技能发现,需同时说明做什么和何时使用,用第三人称。

结构要求:frontmatter 中 name 必填、最长 64 字符,仅小写字母、数字和连字符;description 必填、最长 1024 字符;allowed-tools 和 model 可选。命名建议用动名词形式,如 processing-pdfs、reviewing-code,避免 helper、utils、tools 等。正文使用标准 markdown 标题,如 Quick Start、Instructions、Examples、Guidelines。

使用方式:可选择创建新技能、审计现有技能、添加组件或获取设计指导。创建流程为选择类型、编写 SKILL.md、按需添加引用文件与脚本、用真实任务测试。引用文件保持距 SKILL.md 一层深度;脚本执行而不加载进上下文,例如 python scripts/analyze.py input.pdf > fields.json。

审计清单:有效的 YAML frontmatter、description 含触发关键词、使用 markdown 标题、SKILL.md 少于 500 行、引用一层深度、示例具体、术语一致、无时效性信息、脚本显式处理错误。

应避免:正文用 XML 标签、描述模糊、深层嵌套、选项过多、Windows 路径、把错误处理推给 Claude、时效性信息。

限制:资料未提供具体收费、价格、平台支持范围或效果保证。