1. 准备工作:编写SKILL.md文件
发布技能的第一步是编写符合规范的SKILL.md文件,这是SkillHub识别和使用技能的核心文件。
- 文件结构:SKILL.md包含YAML frontmatter(元数据)和Markdown正文(技能指令)两部分
- 必要元数据:包括name(技能名称)、description(功能描述)、version(版本号)、category(所属分类)、platforms(适用平台)等
- 技能指令编写:在正文部分详细描述技能的使用方法、执行步骤、输出格式等,确保AI能准确理解并执行
2. 通过CLI发布技能
SkillHub提供命令行工具支持技能发布,适合开发者使用。
- 登录认证:执行skillhub login命令,通过浏览器完成OAuth认证,凭证存储在~/.skillhub/auth.json
- 初始化项目:在技能项目目录下执行skillhub init --name <技能名> --category <分类>创建标准项目结构
- 推送文件:执行skillhub push将本地技能文件推送到远程SkillHub平台
- 发布上线:执行skillhub publish将技能发布到公开目录,使其对其他用户可见
3. 通过官网发布技能
SkillHub官网提供图形化发布界面,用户可在网页上完成技能发布流程。
a. 访问发布页面:登录skillhub.cn后,进入技能发布页面
b. 填写技能信息:根据页面提示填写技能名称、描述、分类、标签等元数据信息
c. 上传技能文件:将编写好的SKILL.md及相关文件上传至平台
d. AI辅助生成:官网发布页面提供AI辅助功能,可根据用户描述自动生成技能名称、描述、分类、标签和指令内容
e. 提交审核:完成信息填写后提交审核,等待平台完成安全检测后自动上架
4. 技能发布规范与建议
为提高技能通过审核的概率和后续下载量,建议遵循以下规范:
- 描述清晰准确:技能名称和描述应准确反映功能,避免误导用户
- 文档完整规范:确保SKILL.md文件结构清晰、示例充分、限制说明明确
- 遵守分类标准:将技能发布到最合适的分类下,便于目标用户发现
- 设置合理可见性:使用--visibility参数控制技能可见范围(public公开、unlisted不公开列出、private私有、org组织内可见)