diff --git a/README.md b/README.md index 8695777c..7f1f3bf1 100644 --- a/README.md +++ b/README.md @@ -441,6 +441,44 @@ Run it against a local backend: - OpenAPI TypeScript for type-safe API client - i18next for internationalization +## SkillHub and the Agent Skills Ecosystem + +SkillHub is a **registry and governance platform** — not a skill collection. +It is complementary to open skill catalogs such as +[`anthropics/skills`](https://github.com/anthropics/skills): that repository +popularized the **Agent Skill format** (a `SKILL.md` with `name` / `description` +frontmatter plus supporting files) and ships a curated set of example skills. +SkillHub is where your organization **hosts, versions, governs, and distributes** +those skills privately. + +| | [`anthropics/skills`](https://github.com/anthropics/skills) | **SkillHub** | +|---|---|---| +| What it is | A curated collection of example Agent Skills + the format spec | A self-hosted registry & governance platform for skills | +| Layer | Content — the skills themselves | Infrastructure — hosting, versioning, discovery, access control | +| Hosting | Public GitHub repository | Your own infrastructure, behind your firewall | +| Versioning | Git history | Semantic versions, tags (`beta` / `stable`), `latest` tracking | +| Access control | Public | Namespaces, RBAC, review & audit logging | +| Distribution | Clone / copy files | Full-text search + CLI install | + +Because SkillHub speaks the same `SKILL.md` format, skills from `anthropics/skills` +— or any Agent Skill folder — publish straight into your registry: + +```bash +# Grab a skill from an open collection... +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// +``` + +> ⚖️ **Licensing**: honor each skill's own license when republishing. Most skills in +> `anthropics/skills` are Apache 2.0, but the document skills (DOCX/PDF/PPTX/XLSX) are +> source-available rather than open source — check the skill's `LICENSE` before redistributing. + +**In short: use collections like `anthropics/skills` for content, and SkillHub to +distribute it across your organization under governance.** + ## Usage with Agent Platforms SkillHub works as a skill registry backend for several agent platforms. Point any of the clients below at your SkillHub instance to publish, discover, and install skills. diff --git a/README_zh.md b/README_zh.md index 360c0f46..64397f1d 100644 --- a/README_zh.md +++ b/README_zh.md @@ -360,6 +360,41 @@ SkillHub 采用清晰的分层架构: 完整路线图请参阅 [`docs/10-delivery-roadmap.md`](./docs/10-delivery-roadmap.md)。 +## SkillHub 与 Agent Skills 生态 + +SkillHub 是一个**注册与治理平台**,而不是一个技能集合。它与 +[`anthropics/skills`](https://github.com/anthropics/skills) 这类开放技能仓库是 +**互补关系**:那个仓库推广了 **Agent Skill 格式**(带 `name` / `description` +frontmatter 的 `SKILL.md` 加上配套文件),并提供了一批精选的示例技能;而 SkillHub +则是你的组织**私有地托管、版本化、治理和分发**这些技能的地方。 + +| | [`anthropics/skills`](https://github.com/anthropics/skills) | **SkillHub** | +|---|---|---| +| 定位 | 精选的示例 Agent Skills 集合 + 格式规范 | 自托管的技能注册与治理平台 | +| 层次 | 内容层 —— 技能本身 | 基础设施层 —— 托管、版本、发现、访问控制 | +| 托管 | 公开的 GitHub 仓库 | 你自己的基础设施,部署在防火墙之内 | +| 版本 | Git 提交历史 | 语义化版本、标签(`beta` / `stable`)、`latest` 追踪 | +| 访问控制 | 公开 | 命名空间、RBAC、审核与审计日志 | +| 分发 | 克隆 / 拷贝文件 | 全文搜索 + CLI 安装 | + +由于 SkillHub 使用同一套 `SKILL.md` 格式,`anthropics/skills` 中的技能——或任何 +Agent Skill 目录——都可以直接发布到你的注册中心: + +```bash +# 从开放集合中获取一个技能…… +git clone https://github.com/anthropics/skills + +# ……并将其发布到你的私有 SkillHub 注册中心 +export CLAWHUB_REGISTRY=https://skillhub.your-company.com +npx clawhub publish ./skills/<分类>/<技能名> +``` + +> ⚖️ **许可提示**:转发布时请遵守每个技能各自的许可证。`anthropics/skills` 中大多数技能 +> 采用 Apache 2.0,但文档类技能(DOCX/PDF/PPTX/XLSX)是 source-available 而非开源, +> 再分发前请先查看该技能的 `LICENSE`。 + +**一句话总结:用 `anthropics/skills` 这类集合提供内容,用 SkillHub 在组织内进行受治理的分发。** + ## 与智能体平台集成 SkillHub 设计为与各种智能体平台和框架无缝集成。