SuperAPI AI 工具集

skill-best-practices

智能体与模型

查看项目

更新于 10-16 05:05

技能介绍

用途:指导创建、结构化与改进 Claude 技能(SKILL.md),适用于新建技能、审查现有技能或编写 SKILL.md 时参考。

主要能力:

  1. 技能分类:文档与资产创建、工作流自动化、MCP 增强三类,并建议先定义 2–3 个具体用例。
  2. 目录与文件规范:文件夹用 kebab-case,文件名必须为 SKILL.md(区分大小写),技能文件夹内不放 README.md;可选 scripts/、references/、assets/。
  3. YAML 前置元数据:必填 name(kebab-case,与文件夹同名)与 description(须同时说明做什么和何时使用,1024 字符内,不含 XML 标签);可选 license、compatibility、metadata 等;禁止 XML 尖括号及含 claude、anthropic 的名称。
  4. 描述撰写:结构为“做什么 + 何时使用 + 关键能力”,需包含用户实际会说的触发短语,可加否定触发。
  5. 正文结构:推荐 ## Instructions 编号步骤 → ## Examples → ## Troubleshooting;保持具体可执行,SKILL.md 控制在 5000 词内,详细文档移至 references/ 并链接。
  6. 校验与测试:运行 bash .claude/skills/skill-best-practices/scripts/validate-skills.sh,推送后运行同脚本加 --remote 确认 npx skills add --list 能找到全部技能;用 10–20 条查询测试触发,目标约 90% 相关查询触发且不误触发。
  7. 迭代信号:触发不足则补充触发短语;过度触发则加否定触发并收窄范围;指令被忽略则把关键步骤前置、使用明确措辞。

限制:资料未提供该技能的收费、价格、平台支持范围或效果数据;仓库同步步骤(更新 CLAUDE.md 与 README.md 技能表)为该项目特定要求。