mcpField
C
create-skill

create-skill

github.com/maxedappsAgent 工作流6045 次安装5 周前更新
代码仓库

关于 create-skill

create-skill 是帮助作者为具备能力的 Agent 编写精简指令的技能,涵盖元数据、内容范围、可复用文件、验证命令及真实任务测试。

主要功能

  1. 01技能元数据规范
  2. 02聚焦单一用途的内容
  3. 03辅助文件的使用指导
  4. 04元数据与链接验证
  5. 05真实任务测试

适用场景

  1. 01编写新的 Agent 技能
  2. 02精简技能中的多余流程
  3. 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