skillhub/document/i18n/en/docusaurus-plugin-content-docs/current/04-developer/api/cli-compat.md
tww 19329480c8 feat(docs): complete Docusaurus website with bilingual support
Add complete bilingual (Chinese/English) documentation website:
- Chinese documentation in docs/
- English documentation in i18n/en/
- iFlytek blue theme customization
- Role-based navigation structure
- ToB enterprise value-focused content
2026-03-15 18:36:59 +08:00

1.8 KiB

title sidebar_position description
CLI Compatibility Layer 4 ClawHub CLI protocol compatibility layer

CLI Compatibility Layer

SkillHub provides a ClawHub CLI protocol compatibility layer for seamless migration of existing tools.

Well-known Discovery

GET /.well-known/clawhub.json

Response:

{
  "apiBase": "/api/compat/v1"
}

Compatibility Layer APIs

Whoami

GET /api/compat/v1/whoami

Response:

{
  "handle": "username",
  "displayName": "User Name",
  "role": "user"
}
GET /api/compat/v1/search?q={keyword}&page={page}&limit={limit}

Response:

{
  "results": [
    {
      "slug": "my-skill",
      "name": "My Skill",
      "description": "...",
      "author": {
        "handle": "username",
        "displayName": "User Name"
      },
      "version": "1.2.0",
      "downloadCount": 100,
      "starCount": 50,
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-03-01T00:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}

Resolve

GET /api/compat/v1/resolve?slug={slug}&version={version}

Response:

{
  "slug": "my-skill",
  "version": "1.2.0",
  "downloadUrl": "/api/compat/v1/download/my-skill/1.2.0"
}

Download

GET /api/compat/v1/download/{slug}/{version}

Publish

POST /api/compat/v1/publish
Content-Type: multipart/form-data

file: <zip-file>

Response:

{
  "slug": "my-skill",
  "version": "1.0.0",
  "status": "published"
}

Coordinate Mapping

SkillHub Coordinate ClawHub canonical slug
@global/my-skill my-skill
@team-name/my-skill team-name--my-skill

Next Steps