From 20d20c16d0c0a9c511aba00f1885f77368de5522 Mon Sep 17 00:00:00 2001 From: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com> Date: Thu, 3 Sep 2026 10:44:15 +0800 Subject: [PATCH] docs(compat): separate ClawHub and SkillHub authentication Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com> --- README.md | 5 +++-- README_zh.md | 5 +++-- web/src/docs/skill.md | 9 +++++---- web/src/docs/skill.md.template | 9 +++++---- 4 files changed, 16 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 1de5fd7a..b4e97299 100644 --- a/README.md +++ b/README.md @@ -547,8 +547,9 @@ npx clawhub install my-skill npx clawhub install my-namespace--my-skill # 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 +export SKILLHUB_REGISTRY=https://skillhub.your-company.com +export SKILLHUB_TOKEN=YOUR_API_TOKEN +npx @astron-team/skillhub@latest publish ./my-skill --namespace my-space ``` `my-space--my-skill` is the canonical compat slug. SkillHub parses it as diff --git a/README_zh.md b/README_zh.md index cf47f729..2f56025f 100644 --- a/README_zh.md +++ b/README_zh.md @@ -432,8 +432,9 @@ npx clawhub install my-skill npx clawhub install my-namespace--my-skill # 发布请使用第一方 SkillHub CLI -SKILLHUB_REGISTRY=https://skillhub.your-company.com \ - npx @astron-team/skillhub@latest publish ./my-skill --namespace my-space +export SKILLHUB_REGISTRY=https://skillhub.your-company.com +export SKILLHUB_TOKEN=YOUR_API_TOKEN +npx @astron-team/skillhub@latest publish ./my-skill --namespace my-space ``` 其中 `my-space--my-skill` 是兼容层使用的 canonical slug，SkillHub 会将其解析为 diff --git a/web/src/docs/skill.md b/web/src/docs/skill.md index d884efd3..4727508e 100644 --- a/web/src/docs/skill.md +++ b/web/src/docs/skill.md @@ -1,13 +1,13 @@ --- name: skillhub-registry -description: Use this when you need to search, inspect, install, or publish agent skills against a SkillHub registry. SkillHub is a skill registry with a ClawHub-compatible API layer, so prefer the `clawhub` CLI for registry operations instead of making raw HTTP calls. +description: Use this when you need to search, inspect, install, or publish agent skills against a SkillHub registry. Use ClawHub for compatible read/install workflows and the first-party SkillHub CLI for publishing. --- # SkillHub Registry Use this skill when you need to work with a SkillHub registry: search skills, inspect metadata, install a package, or publish a new version. -> Important: Prefer the `clawhub` CLI for registry workflows. SkillHub exposes a ClawHub-compatible API surface and a discovery endpoint at `/.well-known/clawhub.json`, so the CLI is the safest path for auth, resolution, and download behavior. Only fall back to raw HTTP when debugging the server itself. +> Important: Use `clawhub` for search, inspection, and installation. Its publish protocol is not compatible with SkillHub, so use the first-party SkillHub CLI for publishing. Only fall back to raw HTTP when debugging the server itself. ## What SkillHub Is @@ -115,8 +115,9 @@ ClawHub's upload-ticket protocol is not compatible with SkillHub. Publish with the first-party SkillHub CLI instead: ```bash -SKILLHUB_REGISTRY=https://skillhub.your-company.com \ - npx @astron-team/skillhub@latest publish ./my-skill --namespace my-team +export SKILLHUB_REGISTRY=https://skillhub.your-company.com +export SKILLHUB_TOKEN=sk_your_api_token_here +npx @astron-team/skillhub@latest publish ./my-skill --namespace my-team ``` Publishing requires authentication and membership in the target namespace. diff --git a/web/src/docs/skill.md.template b/web/src/docs/skill.md.template index e8d37205..74e6a581 100644 --- a/web/src/docs/skill.md.template +++ b/web/src/docs/skill.md.template @@ -1,13 +1,13 @@ --- name: skillhub-registry -description: Use this when you need to search, inspect, install, or publish agent skills against a SkillHub registry. SkillHub is a skill registry with a ClawHub-compatible API layer, so prefer the `clawhub` CLI for registry operations instead of making raw HTTP calls. +description: Use this when you need to search, inspect, install, or publish agent skills against a SkillHub registry. Use ClawHub for compatible read/install workflows and the first-party SkillHub CLI for publishing. --- # SkillHub Registry Use this skill when you need to work with a SkillHub registry: search skills, inspect metadata, install a package, or publish a new version. -> Important: Prefer the `clawhub` CLI for registry workflows. SkillHub exposes a ClawHub-compatible API surface and a discovery endpoint at `/.well-known/clawhub.json`, so the CLI is the safest path for auth, resolution, and download behavior. Only fall back to raw HTTP when debugging the server itself. +> Important: Use `clawhub` for search, inspection, and installation. Its publish protocol is not compatible with SkillHub, so use the first-party SkillHub CLI for publishing. Only fall back to raw HTTP when debugging the server itself. ## What SkillHub Is @@ -115,8 +115,9 @@ ClawHub's upload-ticket protocol is not compatible with SkillHub. Publish with the first-party SkillHub CLI instead: ```bash -SKILLHUB_REGISTRY=${SKILLHUB_PUBLIC_BASE_URL} \ - npx @astron-team/skillhub@latest publish ./my-skill --namespace my-team +export SKILLHUB_REGISTRY=${SKILLHUB_PUBLIC_BASE_URL} +export SKILLHUB_TOKEN=sk_your_api_token_here +npx @astron-team/skillhub@latest publish ./my-skill --namespace my-team ``` Publishing requires authentication and membership in the target namespace.