← 返回教程列表

Skills发布与分发完整指南

你花三天写了一个超牛的Skill，结果只有你自己用？这不是技术的问题，是分发的问题。这篇指南教你如何让全世界都用上你的Skills。

目录

  1. 为什么发布很重要
  2. Skills市场选择
  3. ClawHub上架流程
  4. GitHub发布策略
  5. 版本管理
  6. 文档编写
  7. 质量检查
  8. 推广技巧
  9. 商业化路径
  10. 总结

为什么发布很重要

凌晨2点15分，我盯着自己写的Skill代码，突然想到一个问题：如果我的Skill只能被我自己用，那它再牛逼也只是个"私人玩具"。世界上有一种浪费叫"好东西没人知道"，Skills发布就是解决这个问题的。

市场数据：ClawHub Skills总数已突破66,500个（来自竞品监控报告），中文Skills（金山文档、小红书、抖音等）正在快速崛起。市场越大，机会越多。

Skills市场选择

市场优势劣势适用场景
ClawHub官方市场、流量大、集成好审核严格、竞争激烈通用型Skills
GitHub开源社区、版本控制、协作需要自己推广开发者工具
awesome-openclaw-skills精选列表、曝光度高需要PR审核高质量Skills
个人网站完全自主、品牌化需要流量运营商业化Skills

ClawHub上架流程

1. 准备材料

# ClawHub上架清单
my-skill/
├── SKILL.md              # 必需：Skill主文档
├── README.md             # 必需：使用说明
├── package.json          # 必需：元数据
├── examples/             # 推荐：使用示例
│   ├── basic.md
│   └── advanced.md
├── tests/                # 推荐：测试用例
├── assets/               # 可选：截图/演示
│   └── demo.gif
└── LICENSE               # 必需：许可证

2. package.json 规范

{
  "name": "my-awesome-skill",
  "version": "1.2.0",
  "description": "一个很棒的Skill，解决XX问题",
  "main": "SKILL.md",
  "keywords": [
    "openclaw",
    "agent",
    "skill",
    "your-category"
  ],
  "author": "Your Name <your@email.com>",
  "license": "MIT",
  "repository": {
    "type": "git",
    "url": "https://github.com/yourname/my-awesome-skill.git"
  },
  "clawhub": {
    "category": "productivity",
    "tags": ["automation", "workflow"],
    "compatibility": ["openclaw@>=2026.3"],
    "dependencies": [],
    "screenshots": ["assets/demo.gif"]
  }
}

3. 提交审核

# 使用ClawHub CLI提交
clawhub login
clawhub publish ./my-skill \
  --category productivity \
  --tags "automation,workflow" \
  --description "解决XX问题的自动化Skill"

# 等待审核（通常1-3天）
clawhub status my-awesome-skill

GitHub发布策略

仓库命名规范

# 好的命名
openclaw-skill-xxx       # 通用Skill
claude-skill-xxx         # Claude专用
agent-skill-xxx          # Agent通用
miaoquai-xxx-skill       # 品牌前缀

# 不好的命名
my-skill                 # 太泛
test                     # 太随意
skill1                   # 无意义

README.md 模板

# OpenClaw Skill: [Skill名称]

[一句话描述]

## 📦 安装

\`\`\`bash
# 方式1：通过ClawHub安装
clawhub install yourname/skill-name

# 方式2：手动下载
git clone https://github.com/yourname/skill-name.git ~/.openclaw/skills/
\`\`\`

## 🚀 快速开始

[最简单的使用示例]

## 📖 详细文档

[功能说明、参数配置、高级用法]

## 🎯 使用场景

- 场景1
- 场景2

## 🤝 贡献

欢迎提交Issue和PR！

## 📄 许可证

MIT License

版本管理

使用语义化版本号（SemVer）：

版本号格式：MAJOR.MINOR.PATCH

MAJOR: 不兼容的API变更
MINOR: 向后兼容的新功能
PATCH: 向后兼容的问题修正

示例：
1.0.0 - 首次发布
1.1.0 - 新增功能（兼容）
1.1.1 - Bug修复
2.0.0 - 重构，不兼容旧版

CHANGELOG.md 模板

# Changelog

## [1.2.0] - 2026-05-16

### Added
- 新增XX功能
- 支持XX参数

### Changed
- 优化XX性能
- 改进XX逻辑

### Fixed
- 修复XX Bug

## [1.1.0] - 2026-04-20

### Added
- 首次发布核心功能

[1.2.0]: https://github.com/yourname/skill/compare/v1.1.0...v1.2.0

文档编写

文档黄金法则：假设读者是完全的新手，但不要把他们当傻子。每个步骤都要有"为什么"和"怎么做"。

SKILL.md 必备章节

  1. 功能描述 - 一句话说清楚这个Skill做什么
  2. 使用场景 - 什么时候用、为什么用
  3. 安装方法 - 多种方式（ClawHub、手动、依赖）
  4. 快速开始 - 最简单的示例（5行代码内）
  5. 详细文档 - 所有参数、配置、高级用法
  6. 常见问题 - FAQ
  7. 相关链接 - 文档、Demo、社区

质量检查

发布前用这个清单自查：

检查项标准工具
代码质量无语法错误、逻辑清晰openclaw-skill-quality-analyzer
安全性无恶意代码、权限合理ClawShield / skill-security-scan
文档完整性SKILL.md包含所有章节clawhub lint
测试覆盖核心功能有测试用例手动测试 + 自动化
兼容性支持最新版OpenClaw在多个版本测试
# 使用质量分析工具
npx openclaw-skill-quality-analyzer ./my-skill

# 输出示例：
# ✅ 文档完整性: 95/100
# ✅ 代码质量: 88/100
# ⚠️ 测试覆盖: 60/100 (建议补充)
# ✅ 安全性: 100/100

推广技巧

推广1：写好Release Notes
每次发布新版本，写清楚"解决了什么问题"、"新增了什么功能"。用户看的是价值，不是技术细节。
推广2：制作Demo视频
一个30秒的GIF演示比1000字说明更有说服力。用asciinema或Loom录制。
推广3：社区互动
在Reddit r/OpenClaw、Discord、GitHub Discussions分享你的Skill，但别硬广——分享价值，自然引流。

推广渠道优先级

  1. ClawHub - 官方市场，流量最大
  2. GitHub - 开发者社区，质量背书
  3. Reddit r/OpenClaw - 精准用户
  4. Discord社区 - 即时反馈
  5. 技术博客 - 深度内容，SEO价值
  6. Twitter/X - 快速传播

商业化路径

如果你打算通过Skills赚钱：

模式说明适用场景
免费+付费增强基础功能免费，高级功能付费通用工具
企业版针对企业需求定制B2B工具
咨询+培训教别人怎么用你的Skill复杂Skill
SaaS订阅Skill作为SaaS的一部分云服务集成
捐赠GitHub Sponsors / Ko-fi开源爱好者

总结

发布一个Skill只是开始，让更多人用上它才是目标。通过ClawHub上架、GitHub开源、社区推广的组合拳，你的Skill可以从"私人玩具"变成"公共资产"。记住：好东西值得被更多人知道，别让你的代码只活在localhost里。

相关教程

最后更新：2026-05-16 | 妙趣AI - AI工具导航与教程平台