在 clawhub 上发布一个 skill 实际上非常轻松。只需跟随本指南，你就能将自己的能力轻松分享给全球用户。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
---
方法一：本地文件夹上传（新手首选）
第一步：整理本地文件夹
在电脑中新建一个文件夹，其中至少需包含一个 SKILL.md 文件：
your-skill/├── SKILL.md # 必填项├── README.md # 非必需，可选└── rules/ # 非必需，用于存放其他文本或JSON配置
SKILL.md 示例内容如下：
---name: 我的第一个技能description: 一段简洁明了的功能说明---# 提示词与使用说明在此处撰写……
第二步：打开发布入口
前往 https://www.php.cn/link/c9b2c3e73b3b3f66e03d077fbf632764。
#### 第三步：填写关键信息
| 字段 | 填写要求 | 参考示例 |
|---|---|---|
| Slug | 仅限小写字母和短横线，作为URL唯一标识 | `api-tester` |
| Display name | 展示名称，支持中文字符 | `API接口调试助手` |
| Owner | 一般由系统自动填充，可留空 | 无需手动输入 |
| Version | 遵循语义化版本规范 | `1.1.0` |
| Tags | 默认保留 `latest` | `latest` |
| Drop a folder | 点击按钮选择你的技能文件夹 | — |
#### 第四步：完成校验检查
页面底部将实时反馈验证结果，请确认以下几项均通过：
✅ Slug 已正确填写且符合格式规范✅ Display name 已填写✅ MIT-0 许可协议已勾选✅ 文件夹已被成功选定（至少含1个文件）✅ 文件夹内存在有效的 SKILL.md 文件#### 第五步：补充更新日志并提交
在 Changelog 区域简要说明本次发布的变更点，例如：
v1.0.0 初始版本：支持 RESTful API 请求模拟与响应解析
待所有红色错误提示消失后，点击 Publish skill 完成发布。
方法二：GitHub 仓库导入（适用于已有项目）
若你已将技能代码托管至 GitHub，推荐使用该方式快速同步。
操作流程
访问 https://www.php.cn/link/8387418ed9ce2d0e0188fced31bb45d4 Import from GitHub 标签确保目标仓库为 Public 状态输入完整 GitHub 地址，如：https://www.php.cn/link/ba87a8ac2878dbe80b40b23114a7d042 Detect，系统将自动读取元数据并填充表单核对无误后，点击 Publish skill 即可完成导入
---
如何判断发布是否成功？
成功发布后，你会看到：
顶部出现绿色成功提示条自动跳转至技能详情页，网址格式为：https://www.php.cn/link/e5b23b0f61576bf3cd32363d3475c964 ClawHub 主站搜索框中输入技能名称进行检索验证
---
高频问题排查指南
| 现象 | 可能原因 | 应对方案 |
|---|---|---|
| `Slug must be lowercase` | Slug 中含有大写字母 | 统一转为小写，并用短横线分隔单词 |
| `Remove non-text files` | 上传包中混入 `.git`、`.DS_Store` 或 `LICENSE` 等非必要文件 | 清理后再重新打包上传 |
| `GitHub API rate limit exceeded` | 短时间内调用 GitHub 接口次数超限 | 等待约10分钟再试，或改用本地文件夹上传 |
| `Connection lost while action was in flight` | 网络不稳定或上传文件体积过大 | 刷新页面重试，建议精简文件夹内容后再操作 |
