技能分发

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install skill-distribution
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 skill-distribution。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

技能分发帮助开发者让完成的 SKILL.md 出现在需要它的智能体和用户面前。它将发布选项——包括 GitHub、skills.sh、agentskill.sh、ClawHub、Hermes、Claude 和 OpenAI 插件目录、Gemini CLI 扩展以及付费市场——与覆盖范围、受众或收入等目标相对应。
该工作流程强调将单个公开 GitHub 仓库作为事实来源，在提交前进行通用验证，遵循特定渠道的说明，并在发布后测试安装。对于分发 Openclaw Skills 的团队，它还说明了如何在多个注册平台重复使用相同的技能内容，并将其封装为插件或扩展格式，而无需维护重复副本。

应用场景

根据覆盖范围、目标受众或收入，决定在哪里发布已完成的智能体技能。
通过 ClawHub 或 Hermes 技能中心，为 OpenClaw 或 Hermes 用户准备技能。
将一个技能仓库分发到多个注册平台，而无需维护不断产生差异的副本。
将技能打包为 Claude Code、Anthropic、ChatGPT/Codex 或 Gemini CLI 插件或扩展。
检查通用发布要求，并在向注册平台提交前解决问题。
发布后跟踪上架状态、审核等待情况以及由用户负责的任务。

工作原理

明确分发目标：扩大覆盖范围、面向特定智能体受众或获取收入。如果目标不明确，只询问一次，之后默认以覆盖范围为目标。
使用 python scripts/check_skill.py 验证技能，并在继续之前修复通用要求方面的问题。
建立一个公开 GitHub 仓库作为事实来源，并将技能只存放在 skills// 下。
从按目标分类的目录中选择渠道，并且只查阅当前所用渠道对应的参考文件。
在执行任何发布、提交或推送操作之前，取得用户明确批准；如有需要，让用户完成登录、身份验证和付款设置。
按渠道逐一发布；如果目标平台有要求，则将通用技能改装为插件或扩展包。
在干净路径中从已发布的渠道安装，以验证每个上架条目，而不是使用本地文件夹。
报告渠道、状态、上架链接或安装命令，以及任何待处理的审核或用户操作。

配置指南

将技能放入公开 GitHub 仓库，并使用与技能 name 字段相匹配的文件夹名称。
以下方共享仓库布局作为起点；仅为计划支持的目标平台添加插件清单。
发布前运行通用检查器：
python scripts/check_skill.py
根据需要查看 references/checklist.md、references/open-registries.md、references/plugins.md 或 references/paid-marketplaces.md 中针对渠道的指南。由于注册平台规则和费用可能变化，发布前请重新检查所链接的文档。
请用户完成任何必要的账户、身份或付款设置。未经该渠道的批准，不得发布、提交或推送。
发布后，在干净路径中从目标平台安装，以测试上架条目。条件允许时，向用户提供安装命令和上架链接。

数据架构

该技能建议将一个公开仓库作为规范来源，而不是为每个注册平台分别维护副本：
Path Purpose
README.md 说明技能，并为每个受支持的智能体提供可复制粘贴的安装命令。
LICENSE 声明仓库的许可证。
skills//SKILL.md 包含技能；目录名称应与技能的 name 相匹配。
skills//references/ 存放从主技能文件中移出的补充详情。
skills//scripts/ 存放技能专用脚本。
plugin.json 按需使用的 OpenAI 或通用插件清单。
.claude-plugin/plugin.json 按需使用的 Claude Code 插件清单。
.claude-plugin/marketplace.json 使该仓库能够作为自己的 Claude Code 市场。
在 skills/ 下为每项技能保留单一副本，避免注册平台上的副本产生差异，或被内容哈希索引视为不同技能。确保 SKILL.md 远少于 500 行，将较长内容移至 references/，并随着发布变更维护版本和变更日志。

高级特性

跨注册平台分发：
单一仓库布局可支持 skills.sh、agentskill.sh、Claude Code 市场和 OpenAI 插件打包。
插件和扩展打包：
保留相同的
SKILL.md
，同时添加 Claude、ChatGPT/Codex 或 Gemini CLI 所需的清单或封装层。
了解注册平台的渠道选择：
根据覆盖范围、特定受众或变现目标匹配发布途径；选项包括 GitHub 索引、CLI 发布、自动扫描、人工审核目录和付费市场。
发布前验证：
运行通用技能检查器，并在提交到特定注册平台之前修复错误。
安装验证：
在干净位置从上架条目安装，确认已发布的条目可以正常使用。
可发现性指南：
改进技能描述、针对特定智能体的 README 安装命令、加载成本、安全态势、声明的要求和版本维护。
发布保护措施：
发布前要求用户批准，并由用户处理账户访问、身份验证和付款设置。
生态变化检查：
发布前重新核实主要注册平台的文档、费用、许可证要求和移除政策。

name: skill-distribution description: Publish and distribute an agent skill (SKILL.md) so people can find and install it — skills.sh, ClawHub, agentskill.sh, GitHub, the Hermes hub, Claude Code plugin marketplaces and Anthropic's directory, the ChatGPT/Codex plugin directory, Gemini CLI extensions, and paid marketplaces. Use whenever the user has written a skill and asks how to share, publish, upload, list, submit, release, sell, or get installs for it, asks where skills are discovered, asks about the rules or format a registry requires, or wants to turn a skill into a plugin — even if they only name one marketplace. license: MIT-0