Anthropic的skill-creator使用分享

一、目录创建条件分析

根据 SKILL.md 的定义，scripts/、references/、assets/是可选目录，只有在特定需求出现时才会创建：

关键触发点

“If all 3 test cases resulted in the subagent writing acreate_docx.pyor abuild_chart.py, that’s a strong signal the skill should bundle that script.”

这意味着目录是按需创建的，在技能迭代过程中发现需要可复用资源时才会添加。

二、10个示例提示词（覆盖所有功能）

功能覆盖清单：

1. 创建新技能（含完整目录结构）
2. 编写测试用例
3. 运行和评估测试
4. 迭代改进技能
5. 描述优化
6. 打包技能
7. 盲比较
8. 更新现有技能
9. 创建带脚本的技能
10. 创建带参考文档的技能

Demo 1: 创建基础技能（触发 SKILL.md 创建）

提示词：

我想创建一个技能，用于将 Markdown 文件转换为 PDF。当用户说"把这个 md 文件转成 PDF"或者"生成 PDF 文档"时触发。 输出应该是一个 PDF 文件。请帮我创建这个技能。

效果：

• 创建markdown-to-pdf/目录
• 创建markdown-to-pdf/SKILL.md（包含 name、description 和转换步骤）
• 不会创建scripts/、references/、assets/（因为不需要）

Demo 2: 创建带脚本的技能（触发 scripts/ 目录）

提示词：

我需要一个技能来批量处理 CSV 文件。功能包括：1）合并多个 CSV；2）计算列统计信息；3）格式转换为 JSON。 当用户提到"处理 CSV"、"合并数据"、"数据统计"时触发。请创建这个技能并包含必要的 Python 脚本。

效果：

• 创建csv-processor/目录
• 创建csv-processor/SKILL.md
• 创建csv-processor/scripts/目录，包含：
  • merge_csv.py- 合并多个 CSV 文件
  • stats_calculator.py- 计算列统计信息
  • csv_to_json.py- CSV 转 JSON 转换脚本

Demo 3: 创建带参考文档的技能（触发 references/ 目录）

提示词：

帮我创建一个 AWS S3 操作技能。功能包括创建存储桶、上传文件、设置权限。当用户说"S3"、"存储桶"、"上传文件到 AWS"时触发。请包含 AWS S3 API 的参考文档。

效果：

• 创建aws-s3/目录
• 创建aws-s3/SKILL.md
• 创建aws-s3/references/目录，包含：
  • s3-api.md- S3 API 使用参考
  • bucket-policies.md- 存储桶权限策略参考
  • best-practices.md- S3 使用最佳实践

Demo 4: 创建带模板资产的技能（触发 assets/ 目录）

提示词：

我需要一个技能来生成项目报告。报告需要包含：标题页、目录、执行摘要、详细内容、图表。当用户说"生成报告"、"写项目总结"、"创建文档"时触发。 请包含报告模板。

效果：

• 创建report-generator/目录
• 创建report-generator/SKILL.md
• 创建report-generator/assets/目录，包含：
  • report-template.html- 报告 HTML 模板
  • styles.css- 报告样式
  • logo.png- 公司 Logo

Demo 5: 创建完整技能（包含所有目录）

提示词：

帮我创建一个 Vue 组件生成器技能。功能包括：1）根据用户输入生成 Vue 3 组件代码；2）生成单元测试文件；3）生成组件文档。 当用户说"创建 Vue 组件"、"生成组件"、"写组件代码"时触发。请包含：模板文件、代码生成脚本、Vue 3 最佳实践文档。

效果：

• 创建vue-component-generator/目录
• 创建vue-component-generator/SKILL.md
• 创建vue-component-generator/scripts/：
  • generate_component.py- 组件代码生成脚本
  • generate_test.py- 测试文件生成脚本
• 创建vue-component-generator/references/：
  • vue3-best-practices.md- Vue 3 最佳实践
  • component-structure.md- 组件结构规范
• 创建vue-component-generator/assets/：
  • component-template.vue- Vue 组件模板
  • test-template.spec.ts- 测试文件模板

Demo 6: 添加测试用例（触发 evals/ 目录）

提示词：

我已经有一个技能在 /path/to/my-skill，现在需要为它添加测试用例。技能功能是格式化代码。请帮我创建测试用例来验证它的正确性。

效果：

• 创建my-skill/evals/目录
• 创建my-skill/evals/evals.json，包含 2-3 个测试用例：
  • 测试 Python 代码格式化
  • 测试 JavaScript 代码格式化
  • 测试代码错误处理

Demo 7: 运行测试和评估（触发 workspace/ 目录）

提示词：

请运行我刚创建的 markdown-to-pdf 技能的测试用例，并生成评估报告。

效果：

• 创建markdown-to-pdf-workspace/目录
• 创建markdown-to-pdf-workspace/iteration-1/目录
• 运行测试用例（with_skill 和 without_skill）
• 生成benchmark.json和benchmark.md
• 启动评估查看器

Demo 8: 迭代改进技能（触发改进循环）

提示词：

测试结果显示我的 csv-processor 技能在处理大型文件时性能不佳。请帮我改进这个技能。

效果：

• 分析测试结果和反馈
• 改进SKILL.md中的处理逻辑
• 更新scripts/中的脚本（添加分块处理、优化算法）
• 运行新的迭代测试（iteration-2/）
• 生成新的评估报告

Demo 9: 优化技能描述（触发描述优化功能）

提示词：

我的 vue-component-generator 技能触发不够准确，有时该触发时不触发。请帮我优化它的描述。

效果：

• 生成 20 个触发评估查询（should-trigger 和 should-not-trigger）
• 使用scripts/run_loop.py运行优化循环
• 更新SKILL.md的 description 字段
• 显示优化前后的对比和评分

Demo 10: 打包技能（触发打包功能）

提示词：

我已经完成了我的 report-generator 技能的开发和测试，请帮我打包它以便分享给团队成员。

效果：

• 运行python -m scripts.package_skill命令
• 生成report-generator.skill文件
• 提供文件路径供用户下载和安装

三、总结

scripts/、references/、assets/目录的创建完全取决于技能的实际需求：

• scripts/：当技能需要可复用的代码逻辑时创建（如数据处理、文件生成脚本）
• references/：当技能需要参考文档支持时创建（如 API 文档、规范指南）
• assets/：当技能需要模板或静态资源时创建（如 HTML 模板、样式文件）

这10个示例提示词覆盖了skill-creator的全部核心功能：

1. 创建新技能（含各类目录结构）
2. 编写测试用例
3. 运行评估和生成基准
4. 迭代改进
5. 描述优化
6. 打包发布