Skill Creator 是一份用于指导创建高质量技能的技能,来自 storyclaw-official/storyclaw-assistant。
【用途】 该技能用于创建、编辑、改进或审计 AgentSkills。当需要从零开始创建新技能,或被要求改进、审查、审计、整理或清理某个技能时使用。
【什么是技能】 技能是模块化、自包含的包,通过提供专门知识、工作流和工具来扩展 Codex 的能力。可以将其理解为特定领域或任务的“入门指南”——把 Codex 从通用智能体转变为具备程序性知识的专用智能体。
技能可提供:专门工作流(特定领域的多步骤流程)、工具集成(针对特定文件格式或 API 的说明)、领域专长(公司特定知识、schema、业务逻辑)、打包资源(用于复杂和重复任务的脚本、参考与资产)。
【核心原则】
- 简洁是关键:上下文窗口是公共资源,默认假定 Codex 已经足够聪明,只补充它尚未掌握的信息。优先使用简洁示例而非冗长解释。
- 设置合适的自由度:高自由度(基于文本的指令)适用于多种方法都有效、决策依赖上下文的情况;中等自由度(带参数的伪代码或脚本)适用于存在首选模式、允许一定变化的情况;低自由度(特定脚本、少量参数)适用于操作脆弱易错、一致性关键或必须遵循特定顺序的情况。
【技能的结构】 每个技能包含必需的 SKILL.md 文件和可选的打包资源:scripts/(可执行代码)、references/(按需加载到上下文的文档)、assets/(用于输出的文件,如模板、图标、字体)。 SKILL.md 包含 YAML frontmatter(name 与 description,这是 Codex 判断何时使用该技能的唯一字段)和 Markdown 正文(仅在技能触发后加载)。
【不应包含的内容】 技能只应包含直接支持其功能的必要文件,不要创建多余文档,包括 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等。
【渐进式披露设计原则】 采用三级加载系统:元数据(name + description)始终在上下文中(约 100 词);SKILL.md 正文在技能触发时加载(小于 5k 词);打包资源按需加载。SKILL.md 正文应保持在 500 行以内,接近该限制时拆分到单独文件。提供了三种模式:高层指南加引用、按领域组织内容、条件性详情。建议避免深层嵌套引用,较长参考文件应在顶部包含目录。
【技能创建流程】
- 通过具体示例理解技能用途;
- 规划可复用的技能内容(脚本、参考、资产);
- 初始化技能(运行 init_skill.py);
- 编辑技能(实现资源并编写 SKILL.md);
- 打包技能(运行 package_skill.py);
- 基于实际使用进行迭代。
【技能命名】 仅使用小写字母、数字和连字符,名称不超过 64 个字符,优先使用简短的动词开头短语,文件夹名称应与技能名称完全一致。
【使用方式】 初始化命令:scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples]。示例包括:scripts/init_skill.py my-skill --path skills/public;scripts/init_skill.py my-skill --path skills/public --resources scripts,references;scripts/init_skill.py my-skill --path skills/public --resources scripts --examples。
【适用场景】 适用于需要为 Codex 构建专用技能的场景,例如构建图像编辑器技能、PDF 处理技能、前端 Web 应用构建技能、BigQuery 查询技能等需要封装专门工作流或领域知识的任务。
【限制】 相关资料暂未提供该技能的收费、价格、平台支持范围与具体效果数据。