SkillUp#

Overview#

SkillUp 通过一个统一的 shell 入口，对 skill 进行检查、打包和多平台发布。

它被设计成可在 Codex、OpenClaw 中文社区及其他能读取 SKILL.md 并执行 shell 命令的智能体环境中使用。

When to Use#

在这些场景下使用：

• 你要把一个 skill 发布到一个或多个平台
• 你要批量同步整个 skills 仓库
• 你希望尽量避免浏览器自动化
• 你希望优先从环境变量读取凭证，并允许配置文件回退

这些情况不适合使用：

• 任务只是修改 skill 内容，并不需要发布
• 目标平台只能通过浏览器手工完成，且无法用 CLI 或 HTTP 配置替代

Inputs#

统一入口：

bash

./skills/SkillUp/scripts/publish.sh [publish|check|package|redact-check|install-local|rollback] --source <path> [options]

常用参数：

• --source <path>: single skill directory or skill repository root
• --platforms <csv>: github,xiaping,openclaw,clawhub
• --config <path>: path to a local TOML-like config file
• --artifact-dir <path>: where packaged zip files are written
• --result-file <path>: where structured JSON results are written
• --dry-run: validate and package without external publishing
• --fail-fast: stop at the first failure
• --continue-on-error: keep going after failures
• --retry <n>: retry failed publishes
• --redact-mode <mode>: strict, warn, off
• --parallel-publish: 并发发布多个平台
• --sequential-publish: 禁用并发发布

模式：

• check：检查 metadata、命令可用性和平台要求
• package：只校验并打包，不进行远程发布
• publish：校验、打包并执行发布
• doctor：检查本地发布环境是否齐全
• status：查看本地版本和远端平台状态
• bump：自动提升版本号
• redact-check：上传前脱敏检查，扫描目录中的敏感信息
• install-local：把当前 skill 安装到 codex、 openclaw 或两者本地目录
• rollback：从 GitHub release 还原本地 skill 文件到指定版本

Credential Priority#

凭证优先级：

1. Environment variables
2. Config file values

默认支持的环境变量：

• SKILLUP_GITHUB_TOKEN
• SKILLUP_XIAPING_API_KEY
• SKILLUP_OPENCLAW_TOKEN
• SKILLUP_CLAWHUB_TOKEN
• CLAWHUB_TOKEN

Expected Layout#

单个 skill 目录至少应包含：

• SKILL.md

可选的每个 skill 元数据可写在：

• manifest.toml

如果是 skills 仓库模式，根目录下可以包含多个子 skill 目录，每个目录都有自己的 SKILL.md。

为了让 Codex 和 OpenClaw 中文社区都能直接发现并使用这个技能，建议安装到各自的默认技能目录之一：

• ~/.codex/skills/SkillUp
• ~/.openclaw/skills/SkillUp

平台开关：

• 在 manifest.toml 里设置 [github].enabled = false 之类的值，可以跳过某个平台
• 可以把 manifest 中的开关和 --platforms <csv> 组合使用，分别控制“允许的平台集合”和“实际启用的平台集合”

上传前脱敏检查：

• 默认使用 strict 模式，在打包前扫描技能目录中的文本文件
• 命中高风险敏感内容会直接阻止 check、 package、 publish
• 可用 .skillup-ignore 忽略特定文件或 glob 模式
• 如需只提示不阻止，可用 --redact-mode warn

Publish Flow#

1. 从给定 source 路径发现 skill
2. 校验每个 skill 目录
3. 预先获取各平台远端状态并输出发布前差异摘要
4. 打包生成 zip 产物
5. 按要求尝试发布到各个平台
6. 在允许时并发发布多个平台
7. 输出简洁的成功、跳过和失败摘要
8. 把机器可读结果写入 publish-result.json

Examples#

以 dry-run 方式模拟发布单个 skill：

bash

./skills/SkillUp/scripts/publish.sh \
  publish \
  --source ./skills/SkillUp \
  --platforms github,xiaping,openclaw,clawhub \
  --dry-run

只做校验：

bash

./skills/SkillUp/scripts/publish.sh \
  check \
  --source ./skills/SkillUp \
  --result-file ./skills/SkillUp/.skillup-artifacts/check-result.json

只做脱敏检查：

bash

./skills/SkillUp/scripts/publish.sh \
  redact-check \
  --source ./skills/SkillUp

安装到本地智能体目录：

bash

./skills/SkillUp/scripts/publish.sh \
  install-local both \
  --source ./skills/SkillUp

从 GitHub release 回滚本地文件：

bash

./skills/SkillUp/scripts/publish.sh \
  rollback 0.1.7 \
  --source ./skills/SkillUp

使用配置文件发布整个 skills 仓库：

bash

./skills/SkillUp/scripts/publish.sh \
  --source ./skills \
  --config ./skills/SkillUp/config.example.toml

Notes#

• GitHub 发布支持把产物同步到目标仓库，并通过 gh 创建或更新 release
• 发布结果 JSON 现在会同时写出 local_version、 remote_version、 platform_adjusted、 blocking
• 虾评在有 SKILLUP_XIAPING_API_KEY 或配置文件凭证时走 HTTP API
• 虾评分类型会在可能的情况下通过实时分类 API 做校验
• ClawHub 优先使用官方 clawhub CLI，失败后再考虑 HTTP 回退
• OpenClaw 中文社区优先使用 claw 社区 CLI
• 如果你希望 OpenClaw 中文社区自动发现这个技能，请优先放在 ~/.openclaw/skills/SkillUp 或当前 OpenClaw 工作区的 skills/SkillUp
• ClawHub 的服务端 trigger 异常会被单独分类，方便区分平台 bug 和本地打包问题