SkillHub 技能发布完整指南：从编写到上架全流程

摘要

SkillHub 支持开发者将自己编写的 AI Skill 发布到平台，供其他用户安装使用。本文介绍从编写 SKILL.md 文件、通过 CLI 或官网发布、到通过安全审核上架的完整流程，帮助开发者顺利完成技能发布。

对于开发者来说，将自己编写的 AI Skill 发布到 SkillHub 平台，可以让更多用户发现和使用你的技能，同时也能获得社区反馈和持续改进的动力。SkillHub 为开发者提供了完整的技能发布流程。

一、技能发布前的准备工作

在发布技能之前，需要先完成以下准备工作：

1.1 编写 SKILL.md 文件

SKILL.md 文件是 AI Skill 的核心文件，由两部分组成：YAML frontmatter 和 Markdown 正文。

YAML frontmatter 包含技能的元数据，必要字段包括：

• name：技能名称
• description：技能描述
• version：版本号
• category：技能分类
• platforms：支持的平台

Markdown 正文 包含技能的功能说明、使用方法、示例等内容。

1.2 测试技能

在发布之前，需要在本地测试技能，确保技能能够正常工作。

测试内容包括：

• AI 智能体是否能正确读取和理解 SKILL.md 文件
• 技能的功能是否符合预期
• 技能是否在处理边界输入时表现良好

1.3 准备技能文件

将技能的所有文件整理好，包括 SKILL.md 文件和相关资源文件。

二、发布方式一：通过 CLI 发布

通过 CLI 发布适合熟悉命令行操作的开发者。这种方式可以更高效地管理技能的版本和发布流程。

2.1 第一步：安装 SkillHub CLI

如果还没有安装 SkillHub CLI，可以先安装：

curl -fsSL https://skillhub.cn/install/install.sh | bash

安装完成后，验证安装是否成功：

skillhub -h

2.2 第二步：登录认证

在发布技能之前，需要先登录 SkillHub 账号：

skillhub login

执行这个命令后，会提示你输入账号和密码，或者打开浏览器进行登录认证。

2.3 第三步：初始化项目

登录成功后，初始化你的技能项目：

skillhub init --name <技能名> --category <分类>

将 <技能名> 替换为你的技能名称，将 <分类> 替换为你的技能分类（如"金融分析"、"科技开发"等）。

这个命令会创建一个技能项目目录，并生成必要的配置文件。

2.4 第四步：推送文件

将你的技能文件推送到 SkillHub 平台：

skillhub push

这个命令会将你本地的技能文件推送到 SkillHub 平台，但不会立即发布。

2.5 第五步：发布上线

当技能文件推送完成，并且你已经确认技能可以发布时，执行发布命令：

skillhub publish

这个命令会将你的技能提交审核。审核通过后，技能会在 SkillHub 平台上架。

三、发布方式二：通过官网发布

通过官网发布适合不熟悉命令行操作的用户。你可以在 SkillHub 官网上通过图形界面完成技能发布。

3.1 第一步：访问技能发布页面

访问 skillhub.cn，登录你的账号，然后进入技能发布页面。

3.2 第二步：填写技能信息

在技能发布页面，填写你的技能信息，包括：

• 技能名称
• 技能描述
• 版本号
• 技能分类
• 支持的平台

这些信息对应 SKILL.md 文件中的 YAML frontmatter 字段。

3.3 第三步：上传技能文件

上传你的 SKILL.md 文件和相关资源文件。

3.4 第四步：AI 辅助生成（可选）

SkillHub 提供 AI 辅助生成功能，可以帮助你优化 SKILL.md 文件的内容。

如果你觉得自己的 SKILL.md 文件写得不够好，可以使用 AI 辅助生成功能，让 AI 帮你优化。

3.5 第五步：提交审核

填写完技能信息并上传技能文件后，提交审核。

SkillHub 会对你的技能进行三线并行安全审核，包括：

1. 内容合规过滤
2. 科恩实验室深度漏洞扫描
3. 云鼎实验室 AI 模型安全评估

只有全部通过这三线审核的技能，才能在 SkillHub 平台上架。

四、审核上线流程

提交审核后，你的技能会进入审核流程。

4.1 审核时间

审核时间根据技能复杂程度而定。简单技能的审核时间较短，复杂技能的审核时间较长。

4.2 审核结果

审核完成后，你会收到审核结果通知。

审核通过：你的技能会在 SkillHub 平台上架，用户可以在平台上搜索和安装你的技能。

审核不通过：你会收到不通过的原因。根据原因修改技能后，可以重新提交审核。

五、SKILL.md 文件编写建议

为了提高技能审核通过率，在编写 SKILL.md 文件时应注意：

5.1 提供完整的功能说明

确保 SKILL.md 文件包含完整的功能说明，让用户和审核人员能够清楚地了解你的技能的功能。

5.2 提供充分的示例

提供充分的示例，帮助用户理解如何使用你的技能。

5.3 明确说明限制

明确说明你的技能的能力和限制，避免过度承诺。

5.4 确保文档结构清晰

使用清晰的标题层级和格式，让文档易于阅读。

六、TRACE 评测

技能上架后，会接受 TRACE 评测体系的评估。TRACE 评测体系从五个维度评估技能质量：

• T — Trust（可信任度）
• R — Reliability（可靠性）
• A — Adaptability（适用性）
• C — Convention（规范性）
• E — Effectiveness（有效性）

为了提升技能的 TRACE 评测结果，在编写 SKILL.md 文件时应注意规范性，提供完整的功能说明和充分的示例。

七、总结

将你开发的 AI Skill 发布到 SkillHub 平台，可以让更多用户发现和使用你的技能。发布技能有两种方式：通过 CLI 发布和通过官网发布。

在发布技能之前，需要先编写 SKILL.md 文件，并进行本地测试。发布后，技能会进入审核流程。审核通过后，技能会在 SkillHub 平台上架。

如果你有自己的 AI Skill 想法，不妨动手编写并发布到 SkillHub 平台，与社区分享你的成果。

访问 SkillHub 官网 https://skillhub.cn 开始发布你的 AI Skill，让更多用户发现和使用你的技能。