From 923c1df4e12c038dfec399492313071bee7292db Mon Sep 17 00:00:00 2001 From: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com> Date: Thu, 3 Sep 2026 10:40:35 +0800 Subject: [PATCH] docs(compat): remove unsupported publish guidance Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com> --- README.md | 15 ++++++++------- README_zh.md | 15 ++++++++------- docs/openclaw-integration-en.md | 6 +++--- docs/openclaw-integration.md | 6 +++--- web/src/docs/skill.md | 8 +++++--- web/src/docs/skill.md.template | 8 +++++--- 6 files changed, 32 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index 150c2729..1de5fd7a 100644 --- a/README.md +++ b/README.md @@ -515,8 +515,8 @@ Because SkillHub speaks the same `SKILL.md` format, skills from `anthropics/skil git clone https://github.com/anthropics/skills # ...and publish it into your private SkillHub registry -export CLAWHUB_REGISTRY=https://skillhub.your-company.com -npx clawhub publish ./skills// +export SKILLHUB_REGISTRY=https://skillhub.your-company.com +npx @astron-team/skillhub@latest publish ./skills// ``` > ⚖️ **Licensing**: honor each skill's own license when republishing. Most skills in @@ -546,16 +546,17 @@ npx clawhub search email npx clawhub install my-skill npx clawhub install my-namespace--my-skill -# Publish to global namespace -npx clawhub publish ./my-skill --slug my-skill --version 1.0.0 - -# Publish to a team namespace such as my-space -npx clawhub publish ./my-skill --slug my-space--my-skill --version 1.0.0 +# Publishing uses the first-party SkillHub CLI +SKILLHUB_REGISTRY=https://skillhub.your-company.com \ + npx @astron-team/skillhub@latest publish ./my-skill --namespace my-space ``` `my-space--my-skill` is the canonical compat slug. SkillHub parses it as namespace `my-space` plus skill slug `my-skill`. +ClawHub compatibility covers search, inspection, and installation. Its publish +protocol is not compatible with SkillHub; use the first-party CLI shown above. + > 💡 **Tip**: The above commands are not only applicable to OpenClaw, but also to other CLI Coding Agents or Agent assistants by specifying the installation directory (`--dir`). For example: `npx clawhub --dir ~/.claude/skills install my-skill` 📖 **[Complete OpenClaw Integration Guide →](./docs/openclaw-integration.md)** diff --git a/README_zh.md b/README_zh.md index 90ee1ae9..cf47f729 100644 --- a/README_zh.md +++ b/README_zh.md @@ -401,8 +401,8 @@ Agent Skill 目录——都可以直接发布到你的注册中心： git clone https://github.com/anthropics/skills # ……并将其发布到你的私有 SkillHub 注册中心 -export CLAWHUB_REGISTRY=https://skillhub.your-company.com -npx clawhub publish ./skills/<分类>/<技能名> +export SKILLHUB_REGISTRY=https://skillhub.your-company.com +npx @astron-team/skillhub@latest publish ./skills/<分类>/<技能名> ``` > ⚖️ **许可提示**：转发布时请遵守每个技能各自的许可证。`anthropics/skills` 中大多数技能 @@ -431,16 +431,17 @@ npx clawhub search email npx clawhub install my-skill npx clawhub install my-namespace--my-skill -# 发布到 global 空间 -npx clawhub publish ./my-skill --slug my-skill --version 1.0.0 - -# 发布到如 my-space 这样的团队空间 -npx clawhub publish ./my-skill --slug my-space--my-skill --version 1.0.0 +# 发布请使用第一方 SkillHub CLI +SKILLHUB_REGISTRY=https://skillhub.your-company.com \ + npx @astron-team/skillhub@latest publish ./my-skill --namespace my-space ``` 其中 `my-space--my-skill` 是兼容层使用的 canonical slug，SkillHub 会将其解析为 namespace `my-space` 和 skill slug `my-skill`。 +ClawHub 兼容范围包含搜索、查看和安装；其发布协议与 SkillHub 不兼容。 +发布请使用上面的第一方 CLI。 + > 💡 **提示**：上述命令不仅适用于 OpenClaw，通过指定安装目录（`--dir`），也可适用于其他的 CLI Coding Agent 或 Agent 助手。例如：`npx clawhub --dir ~/.claude/skills install my-skill` 📖 **[完整 OpenClaw 集成指南 →](./docs/openclaw-integration.md)** diff --git a/docs/openclaw-integration-en.md b/docs/openclaw-integration-en.md index c04e0388..3726c8ae 100644 --- a/docs/openclaw-integration-en.md +++ b/docs/openclaw-integration-en.md @@ -256,9 +256,9 @@ ClawHub CLI `0.23.3` uses an upload-ticket protocol outside SkillHub's compatibi If the first-party CLI reports insufficient permission: -- Publishing to global namespace (`@global`) requires `SUPER_ADMIN` permission -- Publishing to team namespace requires OWNER or ADMIN role in that namespace -- Contact your administrator for appropriate permissions +- The publisher must be a member of the target namespace; `SUPER_ADMIN` is exempt +- A regular member may submit a publication; visibility and review rules decide whether it is published immediately or enters review +- Contact a namespace administrator to join the target namespace ### Q: Which OpenClaw versions are supported? diff --git a/docs/openclaw-integration.md b/docs/openclaw-integration.md index f76a960f..e6f5e0de 100644 --- a/docs/openclaw-integration.md +++ b/docs/openclaw-integration.md @@ -256,9 +256,9 @@ ClawHub CLI `0.23.3` 使用的上传票据协议不在 SkillHub 兼容范围内 如果第一方 CLI 提示权限不足： -- 发布到全局命名空间（`@global`）需要 `SUPER_ADMIN` 权限 -- 发布到团队命名空间需要是该命名空间的 OWNER 或 ADMIN -- 联系管理员分配相应权限 +- 发布者必须是目标命名空间成员；`SUPER_ADMIN` 例外 +- 普通成员可提交发布，是否直接发布或进入审核由可见性和审核规则决定 +- 联系命名空间管理员加入目标空间 ### Q: 支持哪些 OpenClaw 版本？ diff --git a/web/src/docs/skill.md b/web/src/docs/skill.md index b8ed8bcf..d884efd3 100644 --- a/web/src/docs/skill.md +++ b/web/src/docs/skill.md @@ -111,13 +111,15 @@ npx clawhub install team-name--my-skill ### Publish -Prepare a skill package directory, then publish it: +ClawHub's upload-ticket protocol is not compatible with SkillHub. Publish with +the first-party SkillHub CLI instead: ```bash -npx clawhub publish ./my-skill +SKILLHUB_REGISTRY=https://skillhub.your-company.com \ + npx @astron-team/skillhub@latest publish ./my-skill --namespace my-team ``` -Publishing requires authentication and sufficient permissions in the target namespace. +Publishing requires authentication and membership in the target namespace. ## Authentication And Visibility diff --git a/web/src/docs/skill.md.template b/web/src/docs/skill.md.template index 1d13200f..e8d37205 100644 --- a/web/src/docs/skill.md.template +++ b/web/src/docs/skill.md.template @@ -111,13 +111,15 @@ npx clawhub install team-name--my-skill ### Publish -Prepare a skill package directory, then publish it: +ClawHub's upload-ticket protocol is not compatible with SkillHub. Publish with +the first-party SkillHub CLI instead: ```bash -npx clawhub publish ./my-skill +SKILLHUB_REGISTRY=${SKILLHUB_PUBLIC_BASE_URL} \ + npx @astron-team/skillhub@latest publish ./my-skill --namespace my-team ``` -Publishing requires authentication and sufficient permissions in the target namespace. +Publishing requires authentication and membership in the target namespace. ## Authentication And Visibility