SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场create-agent-skills

create-agent-skills

智能体与模型

查看项目

更新于 10-15 14:52

技能介绍

<objective> create-agent-skills 是一个用于创建、编写、构建和优化 Claude Code Skills 的专家指导技能。当用户需要处理 SKILL.md 文件、编写新技能或改进现有技能时使用。 </objective>

<essential_principles> 技能如何工作：技能是模块化的、基于文件系统的能力，按需提供领域专业知识。本技能教授如何创建有效的技能。

  1. 技能即提示词 所有提示工程最佳实践均适用。要清晰、直接，使用 XML 结构。假设 Claude 很聪明——只补充 Claude 不具备的上下文。

  2. SKILL.md 始终被加载 技能被调用时，Claude 会读取 SKILL.md。利用这一保证：核心原则放在 SKILL.md（不可跳过）；工作流特定内容放在 workflows/；可复用知识放在 references/。

  3. 复杂技能采用路由模式 目录结构示例： skill-name/ ├── SKILL.md # 路由 + 原则 ├── workflows/ # 分步流程（遵循） ├── references/ # 领域知识（阅读） ├── templates/ # 输出结构（复制 + 填充） └── scripts/ # 可复用代码（执行）

SKILL.md 询问“你想做什么？”→ 路由到工作流 → 工作流指定要阅读哪些参考文件。

各文件夹使用时机：

  • workflows/：Claude 遵循的多步骤流程
  • references/：Claude 阅读以获取上下文的领域知识
  • templates/：Claude 复制并填充的一致输出结构（计划、规格、配置）
  • scripts/：Claude 按原样运行的可执行代码（部署、设置、API 调用）

  1. 纯 XML 结构 技能正文中不使用 Markdown 标题（#、##、###）。使用语义化 XML 标签：<objective>、<process>、<success_criteria> 等。内容内部可保留 Markdown 格式（加粗、列表、代码块）。

  2. 渐进式披露 SKILL.md 保持在 500 行以内。将详细内容拆分到参考文件。仅加载当前工作流所需内容。 </essential_principles>

<intake> 入口选项：

  • 创建新技能
  • 审计/修改现有技能
  • 添加组件（workflow/reference/template/script）
  • 获取指导 等待用户响应后再继续。 </intake>

<routing> 创建选项的渐进式披露：

  • 若用户选择“任务执行型技能” → workflows/create-new-skill.md
  • 若用户选择“领域专家型技能” → workflows/create-domain-expertise-skill.md

添加组件选项的渐进式披露：

  • 若用户指定 workflow → workflows/add-workflow.md
  • 若用户指定 reference → workflows/add-reference.md
  • 若用户指定 template → workflows/add-template.md
  • 若用户指定 script → workflows/add-script.md

基于意图的路由（若用户未选择菜单但提供了明确意图）：

  • “audit this skill”、“check skill”、“review” → workflows/audit-skill.md
  • “verify content”、“check if current” → workflows/verify-skill.md
  • “create domain expertise”、“exhaustive knowledge base” → workflows/create-domain-expertise-skill.md
  • “create skill for X”、“build new skill” → workflows/create-new-skill.md
  • “add workflow”、“add reference”等 → workflows/add-{type}.md
  • “upgrade to router” → workflows/upgrade-to-router.md

阅读工作流后，严格遵循执行。 </routing>

<quick_reference> 技能结构快速参考

简单技能（单文件）：

name: skill-name description: 它做什么以及何时使用。

<objective>本技能做什么</objective> <quick_start>立即可操作的指导</quick_start> <process>分步流程</process> <success_criteria>如何判断成功</success_criteria>

复杂技能（路由模式）： SKILL.md： <essential_principles> - 始终适用 <intake> - 要询问的问题 <routing> - 将答案映射到工作流 workflows/： <required_reading> - 要加载哪些参考文件 <process> - 步骤 <success_criteria> - 完成条件 references/：领域知识、模式、示例 templates/：Claude 复制并填充的输出结构（计划、规格、配置、文档） scripts/：Claude 按原样运行的可执行代码（部署、设置、API 调用、数据处理） </quick_reference>

<reference_index> 领域知识（均在 references/ 中）：

  • 结构：recommended-structure.md、skill-structure.md
  • 原则：core-principles.md、be-clear-and-direct.md、use-xml-tags.md
  • 模式：common-patterns.md、workflows-and-validation.md
  • 资产：using-templates.md、using-scripts.md
  • 进阶：executable-code.md、api-security.md、iteration-and-testing.md </reference_index>

<workflows_index> 工作流（均在 workflows/ 中）：

  • create-new-skill.md：从零构建技能
  • create-domain-expertise-skill.md：为 build/ 构建详尽的领域知识库
  • audit-skill.md：对照最佳实践分析技能
  • verify-skill.md：检查内容是否仍然准确
  • add-workflow.md：向现有技能添加工作流
  • add-reference.md：向现有技能添加参考
  • add-template.md：向现有技能添加模板
  • add-script.md：向现有技能添加脚本
  • upgrade-to-router.md：将简单技能转换为路由模式
  • get-guidance.md：帮助决定构建何种技能 </workflows_index>

<yaml_requirements> YAML Frontmatter 必需字段：

name: skill-name # 小写加连字符，与目录名匹配 description: ... # 它做什么以及何时使用（第三人称）

命名约定：create-、manage-、setup-、generate-、build-* </yaml_requirements>

<success_criteria> 一个结构良好的技能应：

  • 具有有效的 YAML frontmatter
  • 使用纯 XML 结构（正文中无 Markdown 标题）
  • 核心原则内联在 SKILL.md 中
  • 根据用户意图直接路由到适当工作流
  • SKILL.md 保持在 500 行以内
  • 仅在真正需要时提出最少的澄清问题
  • 已通过真实使用测试 </success_criteria>