scriptoriumadmin/skillhub
1
0
Fork 0
mirror of https://github.com/iflytek/skillhub.git synced 2026-09-07 08:26:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

docs(compat): separate ClawHub and SkillHub authentication

Browse source 
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
This commit is contained in:
XiaoSeS 2026-09-03 10:44:15 +08:00
parent 923c1df4e1
commit 20d20c16d0
4 changed files with 16 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
README.md
View file

@ -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

5
README_zh.md
View file

@ -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 会将其解析为

9
web/src/docs/skill.md
View file

@ -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.

9
web/src/docs/skill.md.template
View file

@ -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.