← 返回 Skills 市场
zlx

Skill Publisher

作者 Newell Zhu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
39
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install skill-publisher-zlx
功能描述
将 Agent 技能发布到多个平台：ClawHub、GitHub Releases、SkillHub CN。支持验证、打包、版本管理和一键多平台发布。
使用说明 (SKILL.md)

Skill Publisher

将本地 Agent 技能发布到多个平台。支持单平台发布、一键多平台发布，平台可扩展。

平台架构

采用插件式平台注册，每个平台是独立适配器，通过统一元数据声明自己的能力。

skill-publisher/
  SKILL.md
  scripts/
    publish.sh              # 主入口
    platform_registry.sh    # 平台注册表 & 能力发现
    platform_clawhub.sh     # ClawHub 适配器
    platform_github.sh      # GitHub Releases 适配器
    platform_skillhub.sh    # SkillHub CN 适配器
    validate.sh
    version.sh
    status.sh
  references/
    adding-platforms.md     # 如何添加新平台
    platform-interface.md   # 完整接口规范

平台适配器声明（manifest）

每个平台适配器在文件头部以注释形式声明元数据：

# @platform_name: clawhub
# @platform_label: ClawHub (OpenClaw Registry)
# @auth_method: cli          # cli | api_key | oauth | web_login | ssh_key | none
# @auth_check: clawhub whoami
# @auth_hint: "请先运行: clawhub login"
# @upload_type: tarball      # tarball | files | http_api | cli_tool
# @upload_command: clawhub publish
# @requires_bin: clawhub
# @install_hint: "npm i -g clawhub"
# @supports_changelog: true
# @supports_version: true

认证方式（@auth_method）

auth_method 说明 适配器职责
cli CLI 工具自带登录 调用 CLI 检查登录态，给出登录提示
api_key 环境变量或配置文件 检查环境变量，提示设置方式
oauth OAuth 浏览器授权 返回授权 URL，等待 token 输入
web_login 浏览器登录（无 CLI） 打开浏览器，提示粘贴确认码
ssh_key SSH 密钥认证 检查密钥，提示添加到平台
none 无需认证 直接跳过

上传方式（@upload_type）

upload_type 说明 适配器职责
tarball 打包 tar.gz 后上传 主流程打包，适配器接收路径并上传
files 逐文件上传 遍历目录，逐文件调用上传接口
http_api HTTP REST API 构造 HTTP 请求上传
cli_tool 委托第三方 CLI 组装命令行并执行

标准函数接口

# 必选
platform_\x3Cname>_manifest       # 返回元数据 JSON
platform_\x3Cname>_check_auth     # 检查认证
platform_\x3Cname>_publish        # 执行发布

# 可选
platform_\x3Cname>_validate       # 平台特定验证
platform_\x3Cname>_status         # 查询远程版本/状态
platform_\x3Cname>_post_publish   # 发布后钩子
platform_\x3Cname>_help           # 平台帮助信息

主流程

publish \x3Cpath> --to \x3Cplatforms>
  │
  ├─ 1. validate       ← 全局验证
  ├─ 2. version check  ← 版本号管理
  ├─ 3. for each platform:
  │     ├─ manifest    ← 读取平台能力
  │     ├─ check_auth  ← 检查认证
  │     ├─ validate    ← 平台验证（可选）
  │     ├─ package     ← 按 upload_type 打包
  │     ├─ publish     ← 上传
  │     └─ post_publish ← 后钩子（可选）
  └─ 4. summary        ← 汇总结果

内置平台

🟢 ClawHub（OpenClaw 官方）

  • auth: cli（clawhub login）
  • upload: tarball → clawhub publish
  • 支持 slug、changelog、版本管理

🟣 GitHub Releases

  • auth: cli（gh auth login）
  • upload: cli_tool → gh release create
  • 自动创建 tag，附带 tarball

🟠 SkillHub CN（国内 Skills 社区）

  • auth: api_key（SKILLHUB_TOKEN 环境变量）或 web_login（浏览器登录）
  • upload: http_api（POST tarball 到 https://skillhub.cn/api/...）
  • 专为中国用户优化
  • TODO: 待补充具体 API 端点和文档（skillhub.cn 目前无公开 API 文档）

第三方扩展

参考 references/adding-platforms.md，社区可添加：

平台 auth upload 说明
GitLab Packages api_key http_api REST API
Gitee ssh_key cli_tool git push
自建 Registry api_key http_api POST tarball
飞书云盘 oauth files lark-cli 逐文件上传
ClawHub Mirror api_key http_api 镜像站

命令

# 验证
skill-publisher validate \x3Cskill-path>

# 打包
skill-publisher package \x3Cskill-path> [--output \x3Cdir>] [--version \x3Cver>]

# 发布
skill-publisher publish \x3Cpath> --to \x3Cplatform> [平台参数...]
skill-publisher publish \x3Cpath> --to clawhub,github
skill-publisher publish \x3Cpath> --to all
skill-publisher publish \x3Cpath> --to \x3Cplatform> --yes

# 版本管理
skill-publisher version \x3Cskill-path>
skill-publisher version \x3Cskill-path> --bump patch|minor|major
skill-publisher version \x3Cskill-path> --set \x3Cver>

# 状态检查
skill-publisher status \x3Cskill-path>

# 平台管理
skill-publisher platforms list
skill-publisher platforms info \x3Cname>

安全规则

  • 发布前自动 validate，失败则中止
  • 不发布含敏感关键词的文件
  • 认证凭证不写入日志或输出
  • 所有发布操作需用户确认（--yes 跳过）
  • 每次发布记录到 ~/.openclaw/skill-publisher/history.jsonl（不含凭证）

参考

  • ClawHub CLI: clawhub --help
  • GitHub CLI: gh release create --help
  • SkillHub CN: https://skillhub.cn/
  • OpenClaw 技能规范: skill-creator skill
安全使用建议
Install this only if you intend to let it run local shell publishing workflows and use existing GitHub, ClawHub, or SkillHub credentials. Review the skill directory before publishing, because the sensitive-keyword check warns but does not reliably prevent sensitive files from being included in the tarball.
能力标签
requires-walletrequires-oauth-tokenrequires-sensitive-credentials
能力评估
✓ Purpose & Capability
The shell scripts match the stated purpose: validate, package, version, query status, and publish local skill folders to ClawHub, GitHub Releases, and SkillHub CN.
ℹ Instruction Scope
Publishing targets, authentication methods, network endpoints, and confirmation behavior are described, but the claimed sensitive-file protection is only implemented as warnings, so users should not rely on it as a blocker.
✓ Install Mechanism
The artifact contains markdown references and shell scripts only; no install-time hook, background installer, obfuscation, or automatic execution was found.
ℹ Credentials
Use of gh, clawhub, curl, tar, git metadata, SKILLHUB_TOKEN, and CLI login sessions is proportionate for multi-platform publishing, though it necessarily involves external network writes.
ℹ Persistence & Privilege
The only persistence found is a disclosed publish history file at ~/.openclaw/skill-publisher/history.jsonl and optional edits to SKILL.md version fields when the user runs version commands.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install skill-publisher-zlx
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /skill-publisher-zlx 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of skill-publisher. - Publish local Agent skills to multiple platforms: ClawHub, GitHub Releases, SkillHub CN. - Supports validation, packaging, version management, and one-click multi-platform publishing. - Plugin-based adapter architecture enables easy platform extension. - Includes detailed interface specs and guides for adding new platforms. - Enforces safety rules (validate before publish, sensitive file filtering, credential protection). - Provides CLI commands for validation, packaging, publishing, version management, status, and platform info.
元数据
Slug skill-publisher-zlx
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Skill Publisher 是什么？

将 Agent 技能发布到多个平台：ClawHub、GitHub Releases、SkillHub CN。支持验证、打包、版本管理和一键多平台发布。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 39 次。

如何安装 Skill Publisher？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install skill-publisher-zlx」即可一键安装，无需额外配置。

Skill Publisher 是免费的吗？

是的，Skill Publisher 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Skill Publisher 支持哪些平台？

Skill Publisher 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Skill Publisher？

由 Newell Zhu（@zlx）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 留言讨论