SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场skill-creator

skill-creator

智能体与模型

查看项目

更新于 10-16 09:09

技能介绍

用途

Skill Creator 解决的是“随手写出来的智能体技能”与“市场就绪、能在 Intent Solutions 100 分评分标准下拿高分的技能包”之间的差距。它会强制执行 2026 规范（顶层身份字段、${CLAUDE_SKILL_DIR} 路径、带评分的章节），并捕捉那些会导致市场扣分的自相矛盾之处。

它支持两种模式：从零创建带完整验证的新技能，或对已有技能进行评分/审计并给出可操作的修复建议。

主要能力

  • 创建模式：根据用户需求生成完整的、符合规格的技能包目录，包含 SKILL.md，以及按需生成的 scripts/、references/、templates/、assets/、evals/ 子目录，并附创建总结报告（含验证等级与评测结果）。
  • 验证模式：输出 100 分制评分报告，覆盖五个维度（渐进式披露、易用性、实用性、规范符合度、写作风格），并给出按分值排序的修复建议。
  • 自动修复（按需）：补充缺失章节、修正描述模式、把嵌套的元数据移动到顶层。
  • 评测支持：创建 evals/evals.json，至少 3 个场景，迭代直到全部断言通过。
  • 术语沟通：面向从初学者到资深工程师的不同技术水平用户，必要时简要解释术语。

使用方式

通过 Claude Code CLI 使用。用户提示中出现“create a skill / build a skill / new skill”进入创建模式；出现“validate / check / grade / score / audit”进入验证模式。

创建流程：

  1. 先理解需求。如果当前对话中已经包含用户想固化的工作流，会先从对话历史中提取工具、步骤顺序、用户修正、输入输出格式，确认后再继续。随后通过 AskUserQuestion 询问技能身份（名称，kebab-case，建议动名词形式）、用途、执行模型（是否可 /name 调用、是否接受参数 $ARGUMENTS 替换、是否需要隔离上下文 context: fork、是否禁用模型自动调用 disable-model-invocation: true）、所需工具（Bash 必须限定范围，如 Bash(git:)、Bash(npm:)；MCP 工具写作 ServerName:tool_name）、复杂度（仅 SKILL.md / 含脚本 / 含参考资料 / 含模板 / 完整包）、存放位置（全局 ~/.claude/skills/<skill-name>/ 或项目 .claude/skills/<skill-name>/）。
  2. 规划技能：确定自由度（高自由度用于创意/开放式任务，中自由度用于已定义流程但内容灵活的任务，低自由度用于严格输出格式）、工作流模式（顺序、条件分支、向导、计划-验证-执行、反馈循环、清单工作流、搜索-分析-报告）、输出模式（严格模板、灵活模板、示例驱动、可视化 HTML、结构化 JSON/YAML）。
  3. 初始化目录结构：
mkdir -p {location}/{skill-name}
mkdir -p {location}/{skill-name}/scripts      # if needed
mkdir -p {location}/{skill-name}/references   # if needed
mkdir -p {location}/{skill-name}/templates    # if needed
mkdir -p {location}/{skill-name}/assets       # if needed
mkdir -p {location}/{skill-name}/evals        # for eval-driven development

4–10 步：编写、验证、测试、迭代、优化、报告。详细指导见 ${CLAUDE_SKILL_DIR}/references/creation-guide.md。

关键规则：

  • version、author、license、tags、compatible-with 是顶层字段（不要嵌套在 metadata: 下）。
  • 限定 Bash 作用域：Bash(git:*) 而不是裸 Bash。
  • 可选 disallowed-tools 拒绝清单（schema 3.7.0+）绝不能与 allowed-tools 重叠（验证器会报 ERROR）。示例：disallowed-tools: [Bash(rm:*), Bash(curl:*), Bash(wget:*), Bash(sudo:*), Edit(.env), Write(.env)]。默认省略该字段。技能用 kebab-case 的 disallowed-tools，智能体用 camelCase 的 disallowedTools，不可直接复制。
  • 保持 SKILL.md 在 500 行以内，超出则转移到 references/。
  • 描述中包含“Use when”和“Trigger with”以满足企业评分。
  • 名称或描述中不得包含 XML 标签（Anthropic 规范禁止）。
  • 不要包含时间敏感信息；废弃方法放入“old patterns”章节。
  • 对质量关键的工作流加入反馈循环。
  • 运行 python3 ${CLAUDE_SKILL_DIR}/scripts/validate-skill.py --grade {skill-dir}/SKILL.md 验证。

验证流程：定位 SKILL.md（全局或项目路径）→ 运行 python3 ${CLAUDE_SKILL_DIR}/scripts/validate-skill.py --grade {path}/SKILL.md → 对照 100 分评分标准查看等级（A: 90+，B: 80–89，C: 70–79，D: 60–69，F: <60）→ 输出带优先级的修复建议 → 按需自动修复。详细步骤 V1–V5 见 Creation Guide。

示例（创建模式，简单技能）：用户要求创建 code-review 技能，会生成 ~/.claude/skills/code-review/ 下的 SKILL.md 与 evals/evals.json，frontmatter 包含 name、description（含 Use when / Trigger with）、allowed-tools: "Read,Glob,Grep"、version、author、license、model: inherit。

示例（验证模式）：对 ~/.claude/skills/code-review/SKILL.md 评分，输出如 Grade: B (84/100)，改进项包括为描述添加“Trigger with”（+3 分）、添加 ## Output 章节（+2 分）、添加 ## Prerequisites 章节（+2 分）。

前提条件

  • 支持技能功能的 Claude Code CLI（高级功能如 effort、maxTurns 需 v2.1.78+）。
  • Python 3.10+（用于 validate-skill.py、aggregate_benchmark.py 等验证脚本）。
  • 目标技能目录可写（~/.claude/skills/ 或 .claude/skills/）。

配套资源与脚本

  • References：creation-guide.md、source-of-truth.md、frontmatter-spec.md、validation-rules.md、workflows.md、output-patterns.md、schemas.md、anthropic-comparison.md、advanced-eval-workflow.md。
  • Agents：grader.md、comparator.md、analyzer.md。
  • Scripts：validate-skill.py、quick_validate.py、aggregate_benchmark.py、run_eval.py、run_loop.py、improve_description.py、generate_report.py、package_skill.py、utils.py。
  • Eval Viewer：generate_review.py + viewer.html；Assets：eval_review.html；Templates：skill-template.md。

适用场景

  • 从零创建新的智能体技能。
  • 把当前对话中已经成型的工作流固化成技能。
  • 在发布到市场前对已有技能进行验证、评分与审计。
  • 做基于评测的技能开发与描述优化。

限制

  • 官方资料未说明具体平台兼容范围与价格/收费信息，暂未提供。
  • 需要 Claude Code CLI 与 Python 3.10+ 环境。
  • 需要目标技能目录可写。
  • 部分功能依赖较新 CLI 版本（v2.1.78+）以及 schema 3.7.0+ 的 disallowed-tools 字段。

错误处理

  • Name exists：目录已存在 → 换名或确认覆盖。
  • Invalid name：非 kebab-case 或超过 64 字符 → 改为小写连字符形式。
  • Validation fails：缺失字段或反模式 → 运行验证器并修复报告的问题。
  • Resource missing：${CLAUDE_SKILL_DIR}/ 引用指向不存在文件 → 创建文件或修正引用。
  • Undertriggering：描述过于被动 → 增加“Make sure to use whenever...”等措辞。
  • Eval failures：技能未产生预期输出 → 迭代指令并重新测试。
  • Low grade：缺少带评分的章节或字段 → 添加 Overview、Prerequisites、Output 等章节。