关于 create-skill
create-skill 是帮助作者为具备能力的 Agent 编写精简指令的技能,涵盖元数据、内容范围、可复用文件、验证命令及真实任务测试。
主要功能
- 01技能元数据规范
- 02聚焦单一用途的内容
- 03辅助文件的使用指导
- 04元数据与链接验证
- 05真实任务测试
适用场景
- 01编写新的 Agent 技能
- 02精简技能中的多余流程
- 03检查技能元数据与引用
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ maxedapps/ agent-skills --skill create-skill安装后在 Claude Code 中输入/create-skill确认已加载。
详细介绍
创建技能
技能会引导能力出色的 Agent 朝正确方向行动。它不是操作手册。相信 Agent 的判断,只写下它无法独立妥善处理的内容。
Frontmatter
name:使用小写 kebab-case,并与目录名称一致。description:所有路由信息都写在这里,因为只有激活后才会加载正文。格式为:[它的作用]。在[触发条件]时使用此技能。不要用于[相似但不适用的情况]。少于 1024 个字符。
正文
- 每个技能只负责一项工作。尽量控制在 500 个词以内。
- 用通俗的句子或简短的要点说明重要事项及其原因。删掉 Agent 默认就会做的内容。
- 只有在错误代价高昂的操作中,才规定精确步骤,例如破坏性操作、涉及安全的操作或脆弱操作。
- 不要为了流程而添加流程:不要加入检查清单、停止条件、标签系统、报告文件、审核循环,也不要指示使用子 Agent。
- 不要处理小众边缘情况。逐条审视规则:它是否能避免真实且可能发生的错误?如果不能,就删掉。
- 仅在确有大量可复用材料时,才添加
references/、assets/或scripts/,并说明何时使用其中的每个文件。 - 提及其他技能时只使用其名称,绝不使用指向其文件的路径。
完成
- 在此仓库中,运行
node scripts/validate-skill-metadata.mjs <skill>和node scripts/validate-skill-links.mjs <skill>。 - 在一个实际任务中试用该技能,并修复实际出现的问题。
评论
支持 Markdown