skill-creator

Skill Creator - CLI 技能自动化创建工具

技能概述

Skill Creator 是一款零配置的 CLI 技能脚手架工具，可自动化完成从头脑风暴到安装的全流程技能创建，严格遵循 Anthropic 官方最佳实践。

适用场景

1. CLI 功能扩展

当你需要为 GitHub Copilot CLI、Claude Code 或 Codex 平台添加自定义能力时，skill-creator 可以快速生成符合平台规范的技能文件结构，省去手动创建目录、编写元数据和配置模板的繁琐步骤。

2. 自动化任务封装

将重复性的开发工作流、调试步骤或代码审查流程封装为可复用的技能。工具支持交互式头脑风暴，帮助你明确技能用途、触发词类型和适用范围。

3. 领域知识打包

将特定领域的专业知识（如调试技巧、框架规范、部署流程）打包成团队共享的技能库。支持本地仓库安装和全局符号链接两种方式，方便团队协作和个人使用。

核心功能

1. 交互式技能生成

通过引导式问答收集技能需求，包括功能描述、触发短语、技能类型（通用/代码/文档/分析）和目标平台。可选集成 prompt-engineer 技能进行提示词优化，确保技能描述清晰精准。

2. 模板化文件创建

自动生成标准化目录结构，包括 SKILL.md 主文件、README.md 用户文档、references 扩展文档目录、examples 示例目录和 scripts 工具脚本目录。支持模板变量自动替换（技能名、作者、日期、版本等）。

3. 规范验证与安装

内置 YAML 前置数据验证、内容质量检查（字数统计、写作风格）和技能规范检查。验证通过后支持本地仓库安装、全局符号链接安装或两者兼有，并提供详细的完成报告和后续建议。

常见问题

Skill Creator 支持哪些平台？

支持 GitHub Copilot CLI、Claude Code 和 Codex 三种平台。工具会自动检测系统中已安装的平台，并可根据用户选择为单个或多个平台生成对应的技能文件。每个平台的技能目录位置不同（.github/skills/、.claude/skills/、.codex/skills/），工具会自动适配。

创建的技能有字数限制吗？

是的。SKILL.md 主文件建议保持在 1500-2000 字，最大不超过 5000 字。README.md 用户文档建议 300-500 字。当内容过长时，应将详细文档移至 references/ 目录。工具会验证字数并给出提示，帮助你遵循渐进式披露原则，保持技能核心信息的简洁性。

如何验证技能是否符合规范？

工具内置验证脚本，可检查 YAML 前置数据完整性、描述格式（需使用第三人称）、字数限制、写作风格（禁用第二人称）以及必填字段。验证通过后才能进行安装。常见问题如描述格式错误或字数超标可自动修复，复杂问题会给出详细提示。