用途:这是一个示例技能,演示 Anthropic SKILL.md 格式,展示如何用渐进式披露为 AI 编程智能体组织过程性指导。
适用场景:学习技能如何工作、测试 OpenSkills 加载器、理解 SKILL.md 格式时加载。
创建技能的方式:先创建目录,命令为 mkdir my-skill/;再添加带 YAML frontmatter 的 SKILL.md,其中包含 name 与 description 字段;指令使用祈使形式而非第二人称;按需引用随附资源。
随附资源:关于 SKILL.md 规范的详细信息见 references/skill-format.md。
最佳实践:使用祈使或不定式形式,例如“To do X, execute Y”,避免“You should...”这类第二人称;SKILL.md 保持在 5,000 词以内;将详细内容移至 references/;可执行代码放入 scripts/;模板与输出文件放入 assets/。
资源解析:技能加载时会提供基础目录,例如 Base directory: /path/to/my-first-skill。相对路径从基础目录解析,如 references/skill-format.md 解析为 /path/to/my-first-skill/references/skill-format.md,scripts/helper.sh 解析为 /path/to/my-first-skill/scripts/helper.sh。
限制:资料未提供收费、价格、平台支持范围或实际效果等信息。