用途
create-skill 用于将一个可重复使用的 AI 提示词或工作流,转化为结构化、可分享的技能,供 affiliate-skills GitHub 仓库使用。其输出是一个完整的 SKILL.md 文件,可在任意 AI 智能体中运行,并通过 npx skills add Affitor/affiliate-skills 分享,任何人都可以安装。
该技能属于 Stage S8: Meta。
何时使用
- 用户有一个反复使用的提示词,想把它变成可分享的技能
- 用户想为 affiliate-skills 仓库创建一个新技能
- 用户想按标准格式编写 SKILL.md 文件
- 用户说“把这个做成一个技能”或“为 X 写一个技能”
- 用户想打包一个 AI 工作流,以便他人复现
输入结构
输入字段包括:
- raw_prompt(必填):提示词、工作流描述,或对技能功能的详细说明
- failure_modes(可选):输出不佳时会出现什么问题,有助于编写更好的 Instructions 和 Error Handling
- niche(可选):类别提示,例如 "content"、"research"、"seo"
- examples(可选):用户已有的示例输入/输出对
工作流程
- 理解提示词实际做什么:分析任务类型、可变输入、固定结构、质量差异点、失败模式。如果用户描述模糊,询问他们通常粘贴到 ChatGPT/Claude 的内容、输出良好时的样子、以及出问题时的表现。
- 确定技能元数据:包括 name、slug、category(research、content、seo、landing、distribution、analytics、automation、meta 之一)、level(beginner/intermediate/advanced)、stage(S1-Research 至 S8-Meta)、tags、tools。
- 编写 SKILL.md:按指定结构包含 frontmatter、标题与简介、When to Use、Input Schema、Workflow、Output Schema、Output Format、Error Handling、Examples、Flywheel Connections、Quality Gate、References。
- 编写 README 描述:面向社区,用于 GitHub 和 affiliate-skills 注册表,包含开头、When to Use、差异点、指令摘要、所需输入、输出格式、示例、提示。
- 组装输出:分别呈现 SKILL.md 和 README 描述。
- 自校验:检查所有必需部分、工作流步骤质量、输出格式占位符、示例数量、错误处理、质量门可测试性、描述具体性、frontmatter 名称与 slug 一致。
输出结构
输出字段包括 output_schema_version、skill_md(完整 SKILL.md 内容)、listing(name、slug、description、content、category、level、tags)、metadata(stage、tools_needed、estimated_time)。
输出格式
技能产生两个输出:
- SKILL.md 文件:包含 frontmatter、标题、Stage、When to Use、Input Schema、Workflow、Output Schema、Output Format、Error Handling、Examples、Flywheel Connections、Quality Gate、References。
- README / 注册表描述:包含技能信息表格(Name、Slug、Category、Level、Tags、Install)和面向社区的描述。
错误处理
- 用户给出模糊描述而非提示词:要求提供实际粘贴到 AI 的提示词,或具体输入与预期输出示例。
- 提示词过于简单:如果只是单句且无可变输入,告知用户这不需要做成技能。
- 提示词功能过多:如果工作流有 10 个以上不同步骤,建议拆分为 2-3 个聚焦技能。
- 没有清晰输出格式:要求提供 1-2 个示例,据此构建 Output Format。
- 用户想复制现有技能:检查仓库中是否已有类似技能,建议改进而非重复创建。
适用场景
适用于把反复使用的 ChatGPT 提示词转化为技能、打包跨多个工具的工作流、以及为 affiliate-skills 仓库贡献新技能。示例包括将比较类博客文章提示词转化为 comparison-post-writer 技能,或将产品研究加评论写作工作流打包为 product-review-writer 技能。
限制
对于过于简单、没有可变输入和结构化输出的提示词,该技能会建议不创建技能。对于步骤过多、跨领域的工作流,会建议拆分。具体收费、价格、平台效果等信息暂未提供。