← Back to Skills Marketplace
zlx

Skill Publisher

by Newell Zhu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
39
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install skill-publisher-zlx
Description
将 Agent 技能发布到多个平台：ClawHub、GitHub Releases、SkillHub CN。支持验证、打包、版本管理和一键多平台发布。
README (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
Usage Guidance
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.
Capability Tags
requires-walletrequires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install skill-publisher-zlx
  3. After installation, invoke the skill by name or use /skill-publisher-zlx
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug skill-publisher-zlx
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Skill Publisher?

将 Agent 技能发布到多个平台：ClawHub、GitHub Releases、SkillHub CN。支持验证、打包、版本管理和一键多平台发布。 It is an AI Agent Skill for Claude Code / OpenClaw, with 39 downloads so far.

How do I install Skill Publisher?

Run "/install skill-publisher-zlx" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Skill Publisher free?

Yes, Skill Publisher is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Skill Publisher support?

Skill Publisher is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Skill Publisher?

It is built and maintained by Newell Zhu (@zlx); the current version is v1.0.0.

More 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

💬 Comments