技能注册中心 iflytek/skillhub

SkillHub
企业级开源智能体技能注册中心——发布、发现并管理组织内可复用的技能包。

SkillHub 是自托管平台，为团队提供私有、可治理的智能体技能共享空间。发布技能包，推送到命名空间，其他人就能通过搜索找到它，或用命令行安装。专为防火墙后的本地部署打造，体验与公共注册中心一样精致。

⭐ 如果 SkillHub 适合你的团队，请给仓库点个 star，帮更多团队找到它；再设置 Watch → Custom → Releases，新版本发布时就能收到通知。

分享优秀技能

优秀技能分享出去才更有价值。如果你有某个技能，在真实工作或日常生活中已经证明好用，就把它分享给 SkillHub 社区，帮助壮大开放、实用的技能生态。欢迎各种技能：日常生活、办公、学习与研究、旅行与活动、内容创作、数据分析、软件开发，不只是工程工作流。

高质量的社区贡献有机会进入精选入门合集，让新部署的 SkillHub 从第一天起就好用。不必等完整适配做完再参与：开一个 issue，附上技能来源和它解决的问题；或者按技能分享指南提交 PR。

文档

- 📖 用户指南 — 技能发布、搜索、命令行用法等用户指南
- 🛠️ 开发者文档 — 架构、API 参考、本地开发、部署与运维
- 🐍 Python 示例 — 用 Python 通过 REST API 搜索、下载、发布技能

治理与安全

- 隐私与数据治理 —公开实例与自托管实例的数据分类、运营方责任、保留期限、可移植性和事件处理
- 内容安全 — 包安全预期、审核与举报控制、申诉、儿童安全责任
- 行为准则 — 社区规范与私密举报渠道
- 安全策略 —私密漏洞报告与协同披露

亮点

- 自托管与私有化 — 部署在你自己的基础设施上。
把专有技能留在防火墙内，数据完全自主。一条 make dev-all 命令即可在本地跑起来。
- 发布与版本 — 上传智能体技能包，支持语义化版本、自定义标签（beta、stable），自动跟踪 latest。
- 发现 — 全文搜索，可按命名空间、下载量、评分、时间筛选。可见性规则确保用户只看到自己有权查看的内容。
- 团队命名空间 — 按团队或全局范围组织技能。
每个命名空间有自己的成员、角色（Owner / Admin / Member）和发布策略。
- 审核与治理 — 团队管理员在本命名空间内审核；平台管理员把关晋升到全局范围。治理操作记入审计日志，满足合规要求。
- 社交功能 — 收藏技能、评分、跟踪下载量。
围绕组织的最佳实践建立社区。
- 账号合并 — 把多个 OAuth 身份和 API token 归并到单个用户账号下。
- API Token 管理 — 为命令行和程序化访问生成限定范围的 token，采用基于前缀的安全哈希。
- 命令行优先 — 原生 REST API，外加兼容层，支持现有的 ClawHub 风格注册中心客户端。原生命令行 API 是主要支持的路径，协议兼容性还在持续扩展。
- 可插拔存储 — 开发用本地文件系统，生产用 S3 / MinIO。改配置就能切换。
- 国际化 — 多语言支持，基于 i18next。

快速开始

用下面的命令启动完整本地栈：

curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up

默认命令拉取 latest 稳定版镜像。想用 main 上的最新构建，加 --version edge。

配置公网 URL（生产环境推荐）：

curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --public-url https://skillhub.your-company.com

--public-url 参数设置 SkillHub 实例的公网访问 URL。这样能保证：
- 命令行安装命令显示正确的注册中心 URL
- 智能体配置说明显示正确的 skill.md URL
- OAuth 回调和设备认证链接正常工作

中国用户（阿里云镜像）：

curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --aliyun --public-url https://skillhub.your-company.com --version latest

重跑或更新部署时，保留现有的 runtime home。runtime 脚本会复用它的 .env.release 文件；删掉目录会丢掉你的自定义配置，包括公网 URL 和生成的匿名下载 cookie 密钥。

部署出问题时，先看 runtime 脚本打印的 ps 和 logs 生命周期命令，再用同一个 runtime home 重试 up。确实想要全新配置，就先备份 .env.release，再清空 runtime home。

SkillHub 命令行

从命令行安装和管理智能体技能：

Install CLI
npm install -g @astron-team/skillhub

Or run directly
npx @astron-team/skillhub@latest version

Login
skillhub login --token sk_xxx --registry https://skill.xfyun.cn

Search and install skills
skillhub search pdf
skillhub install pdf-parser --agent codex

List installed skills
skillhub list

📖 完整指南：docs/skillhub/en/guide/cli.md

前置条件

- Docker 和 Docker Compose

本地开发

make dev-all

中国开发者注意：Maven 依赖下载超时的话，配置阿里云镜像。详见本地开发指南。

然后打开：

- Web UI：http://localhost:3000
- 后端 API：http://localhost:8080

默认情况下，make dev-all 用 local 配置档启动后端。
这个模式下，本地开发保留下面的 mock-auth 用户，同时默认创建一个基于密码的引导管理员账号：

- local-user，用于常规发布和命名空间操作
- local-admin，带 SUPER_ADMIN，用于审核和管理流程本地开发时，配合 X-Mock-User-Id 请求头使用。

application-local.yml 默认启用本地引导管理员：

- 用户名：admin
- 密码：ChangeMe!2026
- 要关闭它，启动后端前设置 BOOTSTRAP_ADMIN_ENABLED=false。

停止所有服务：

make dev-all-down

重置本地依赖，从干净状态重新开始：

make dev-all-reset

运行 make help 查看所有可用命令。

常用后端命令：

make test
make test-backend-app
make build-backend-app

不要在 server/ 下直接运行 ./mvnw -pl skillhub-app clean test。
skillhub-app 依赖同一仓库中的兄弟模块，单独执行 clean 构建可能回退到本地 Maven 仓库里的旧产物，从而报出误导性的 cannot find symbol 和签名不匹配错误。请加上 -am，或使用上面的 make test-backend-app 和 make build-backend-app 目标。

完整开发流程（本地开发 → 预发 → PR）见 docs/dev-workflow.md。

API 契约同步

Web 客户端的 OpenAPI 类型已提交到仓库。
后端 API 契约变更时，重新生成 SDK 并提交更新后的生成文件：

make generate-api

要做更严格的端到端漂移检查，运行：

./scripts/check-openapi-generated.sh

该脚本会启动本地依赖、拉起后端、重新生成前端 schema，如果仓库中的 SDK 已过期就报错。

容器运行时

发布的运行时镜像由 GitHub Actions 构建并推送到 GHCR。
如果你想要开箱即用的本地环境，又不想在本机构建后端或前端，这是受支持的路径。
发布的服务端和 Web 镜像支持 linux/amd64、linux/arm64 和 linux/riscv64；扫描器镜像目前支持 linux/amd64 和 linux/arm64。

用 curl 快速部署：

Default (GHCR images)
curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --public-url https://skillhub.your-company.com

Aliyun mirror (recommended for users in China)
curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --aliyun --public-url https://skillhub.your-company.com --version latest

部署参数：

| 参数 | 说明 | 示例 |
| --public-url <url> | 公网访问 URL（推荐） | --public-url https://skill.example.com |
| --version <tag> | 指定镜像 tag | --version v0.2.0 |
| --aliyun | 使用阿里云镜像（中国） | --aliyun |
| --home <dir> | 运行时目录 | --home /opt/skillhub |
| --no-scanner | 关闭安全扫描器 | --no-scanner |

重要：生产部署请配置 --public-url，确保命令行安装命令和智能体配置说明显示正确的 URL。

子路径部署时，保持公网 URL 与运行时基础路径一致， .env.release：设置 SKILLHUB_PUBLIC_BASE_URL=https://skill.example.com/skillhub、 SKILLHUB_WEB_BASE_PATH=/skillhub/ 和 SKILLHUB_WEB_API_BASE_URL=/skillhub。

手动部署：

1. 复制运行时环境模板。
2. 选一个镜像标签。
3. 用 Docker Compose 启动整套服务。

cp .env.release.example .env.release

推荐的镜像标签：

- SKILLHUB_VERSION=latest：最新稳定版（默认）
- SKILLHUB_VERSION=edge：最新 main 构建
- SKILLHUB_VERSION=vX.Y.Z：固定版本

启动运行时：

make validate-release-config
docker compose --env-file .env.release -f compose.release.yml up -d

然后打开：

- Web UI：SKILLHUB_PUBLIC_BASE_URL 对应的地址
- 后端 API：http://localhost:8080

停止服务：

docker compose --env-file .env.release -f compose.release.yml down

运行时栈使用自己的 Compose 项目名，因此不会和 make dev-all 启动的容器冲突。

生产 Compose 栈现在默认只启用 docker 配置档。它不会启用本地 mock 认证。发布模板（.env.release.example）默认启用引导管理员，所以通过 runtime.sh 零配置快速启动即可直接使用：

- 用户名：admin
- 密码：ChangeMe!2026

推荐的生产基线：

- 把 SKILLHUB_PUBLIC_BASE_URL 设为最终的 HTTPS 入口
- 如果服务发布在 /skillhub/ 这类子路径下，还要设置 SKILLHUB_WEB_BASE_PATH=/skillhub/ 和 SKILLHUB_WEB_API_BASE_URL=/skillhub
- 让 PostgreSQL / Redis 只绑定 127.0.0.1
- 通过 SKILLHUB_STORAGE_S3_* 使用外部 S3 / OSS
- 把 BOOTSTRAP_ADMIN_PASSWORD 改成强密码（validate-release-config.sh 会拒绝默认的 ChangeMe!2026）
- 初始设置完成后轮换或停用引导管理员
- 在 docker compose up -d 之前运行 make validate-release-config

如果 GHCR 包仍是私有的，在 docker compose up -d 之前先运行 docker login ghcr.io。

上传白名单覆盖

技能包上传校验使用默认扩展名白名单，来自 SkillPackagePolicy.java。
SkillPublishProperties 默认把同一份列表用于 skillhub.publish.allowed-file-extensions。

如果需要在运行时替换默认白名单，设置：

SKILLHUB_PUBLISH_ALLOWED_FILE_EXTENSIONS=.md,.json,.xsd,.xsl,.dtd,.docx,.xlsx,.pptx

Spring Boot 把这个环境变量绑定到 skillhub.publish.allowed-file-extensions。设置后，它会替换默认白名单，而不是追加。

监控

Prometheus + Grafana 监控栈位于 monitoring/。
它抓取后端的 Actuator Prometheus 端点。

启动方式：

cd monitoring
docker compose -f docker-compose.monitoring.yml up -d

然后打开：

- Prometheus：http://localhost:9090
- Grafana：http://localhost:3001（admin / admin）

默认情况下，Prometheus 会抓取 http://host.docker.internal:8080/actuator/prometheus，所以先在本地 8080 端口启动后端。

Kubernetes

基础 Kubernetes 清单放在 deploy/k8s/ 下：

- configmap.yaml
- secret.yaml.example
- backend-deployment.yaml
- frontend-deployment.yaml
- services.yaml
- ingress.yaml

如果需要可配置的部署，并自带 PostgreSQL 和 Redis 依赖，请使用 charts/skillhub/ 下的 Helm chart：

helm dependency build ./charts/skillhub
helm upgrade --install skillhub ./charts/skillhub \
--namespace skillhub \
--create-namespace \
-f values-production.yaml

必填密钥、Ingress/TLS、外部数据服务、存储迁移和升级限制，见 Helm chart 指南。

创建好自己的 secret 后，再应用这些清单：

kubectl apply -f deploy/k8s/configmap.yaml
kubectl apply -f deploy/k8s/secret.yaml
kubectl apply -f deploy/k8s/backend-deployment.yaml
kubectl apply -f deploy/k8s/frontend-deployment.yaml
kubectl apply -f deploy/k8s/services.yaml
kubectl apply -f deploy/k8s/ingress.yaml

冒烟测试

轻量冒烟测试脚本在 scripts/smoke-test.sh。

对本地后端运行：

./scripts/smoke-test.sh http://localhost:8080

本地 Compose 和 staging 运行可以继续共用一个后端 URL。如果是 ingress 部署，公开 URL 暴露应用 API，但 Actuator 仍留在后端服务上，这时要单独设置 Actuator 目标：

ACTUATOR_BASE_URL=http://skillhub-server:8080 \
./scripts/smoke-test.sh https://skillhub.example.com

健康检查要求 Actuator 返回 JSON 响应，所以如果拿到的是 HTML SPA 回退页，会报路由或目标错误，而不是判为健康检查成功。

只有显式提供当前管理员凭据时，才会运行管理员标签管理冒烟检查：

SMOKE_ADMIN_USERNAME=admin SMOKE_ADMIN_PASSWORD='current-password' \
./scripts/smoke-test.sh http://localhost:8080

在持久环境里，如果只想跑非管理员冒烟检查，请设置 SMOKE_ADMIN_CHECKS=false。脚本不再回退到 bootstrap 管理员密码默认值。

架构

后端（Spring Boot 3.2.3，Java 21）：
- 多模块 Maven 项目，采用整洁架构
- 模块：app、domain、auth、search、storage、infra
- PostgreSQL 16，使用 Flyway 迁移
- Redis 管理会话
- S3/MinIO 存储技能包

前端（React 19、TypeScript、Vite）：
- TanStack Router 负责路由
- TanStack Query 负责数据获取
- Tailwind CSS + Radix UI 负责样式
- OpenAPI TypeScript 提供类型安全的 API 客户端
- i18next 负责国际化

SkillHub 与智能体技能生态

SkillHub 是注册与治理平台，不是技能集合。
它与 anthropics/skills 这类开放技能目录互补：那个仓库让 Agent Skill 格式流行起来（SKILL.md 带 name / description frontmatter，外加配套文件），并提供一组精选示例技能。
SkillHub 负责的是：你的组织如何托管、版本化、治理、分发这些技能，且全程私有。

| | anthropics/skills | SkillHub |
| 是什么 | 精选的示例 Agent Skills 集合 + 格式规范 | 自托管的技能注册与治理平台 |
| 层次 | 内容——技能本身 | 基础设施——托管、版本化、发现、访问控制 |
| 托管 | 公开 GitHub 仓库 | 你自己的基础设施，部署在防火墙内 |
| 版本化 | Git 历史 | 语义化版本、标签（beta / stable）、latest 跟踪 |
| 访问控制 | 公开 | 命名空间、RBAC、评审与审计日志 |
| 分发 | 克隆 / 复制文件 | 全文搜索 + 命令行安装 |

SkillHub 使用同一套 SKILL.md 格式，所以 anthropics/skills 里的技能——或任何 Agent Skill 文件夹——都能直接发布进你的注册中心：

Grab a skill from an open collection...
git clone https://github.com/anthropics/skills

...and publish it into your private SkillHub registry
export SKILLHUB_REGISTRY=https://skillhub.your-company.com
export SKILLHUB_TOKEN=YOUR_API_TOKEN
npx @astron-team/skillhub@latest publish ./skills/<category>/<skill-name>

⚖️ 许可：重新发布时请遵守每个技能自己的许可。anthropics/skills 里多数技能是 Apache 2.0，但文档类技能（DOCX/PDF/PPTX/XLSX）属于源码可见而非开源——再分发前先看技能的 LICENSE。

一句话：内容用 anthropics/skills 这类集合，分发用 SkillHub，在全组织范围内受治理地铺开。

配合智能体平台使用

SkillHub 可以作为多个智能体平台的技能注册后端。把下面任意客户端指向你的 SkillHub 实例，就能发布、发现、安装技能。

OpenClaw

OpenClaw 是开源的智能体技能命令行工具。把它配置成使用你的 SkillHub 端点作为注册中心：

Configure registry URL
export CLAWHUB_REGISTRY=https://skillhub.your-company.com

Authenticate once if needed
clawhub login --token YOUR_API_TOKEN

Search and install skills
npx clawhub search email
npx clawhub install my-skill
npx clawhub install my-namespace--my-skill

Publishing uses the first-party SkillHub CLI
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 是规范兼容 slug。SkillHub 会把它解析成命名空间 my-space 加技能 slug my-skill。

ClawHub 兼容覆盖搜索、查看和安装。它的发布协议与 SkillHub 不兼容，请使用上面展示的第一方命令行。

💡 提示：上面的命令不只适用于 OpenClaw，也适用于其他命令行编程智能体或智能体助手，只要指定安装目录（--dir）即可。例如：npx clawhub --dir ~/.claude/skills install my-skill

📖 OpenClaw 完整集成指南 →

Hermes Agent

Hermes Agent 使用标准 SKILL.md 格式，会递归发现 $HERMES_HOME/skills/ 下的技能。用 SkillHub 命令行的显式 --dir 选项，把完整的 SkillHub 包安装进 Hermes，无需注册表适配器，然后用 hermes skills list 验证。

📖 Hermes Agent 完整集成指南 →

DeepSeek Harness

DeepSeek Harness（dsh）会从 .dsh/skills 和共享的 .agents/skills 根目录发现标准 SKILL.md 包。用第一方 SkillHub 命令行直接装进它的原生用户目录：

skillhub install my-skill --agent dsh --scope user

项目级安装使用 <repository>/.dsh/skills，请在仓库根目录下运行。dsh 会监视自己的技能根目录，新装的技能无需重启进程即可被发现。

📖 DeepSeek Harness 完整集成指南 →

HarnessClaw Engine

HarnessClaw Engine 是 Go 编写的 LLM 编程助手引擎，通过 WebSocket 对外提供能力。它从带 YAML frontmatter 和参数替换的 SKILL.md 文件加载技能，扫描每个配置目录下的 skill-name/SKILL.md（默认 ~/.harnessclaw/workspace/skills/，名称冲突时靠前的目录优先）。用命令行的 --dir 选项把 SkillHub 包直接装进该目录，无需注册表适配器：

npx clawhub --dir ~/.harnessclaw/workspace/skills install my-skill

AstronClaw

AstronClaw 是云 AI 助手，基于 OpenClaw 的核心能力构建，通过企业微信、钉钉、飞书等企业平台提供 7×24 小时在线服务。它内置技能系统，官方技能超过 130 个。你可以把它连接到自建的 SkillHub 注册表，在组织内实现一键安装技能、搜索仓库、对话式自动安装，甚至自定义技能管理。

Loomy

Loomy 是桌面 AI 工作伙伴，专注真实办公场景。它与本地文件和系统工具深度集成，为个人和小团队搭建高效的自动化工作流。把 Loomy 接入你的 SkillHub 注册表，就能轻松发现并安装组织专属技能，提升本地桌面自动化与生产力。

astron-agent

astron-agent 是讯飞 Astron 智能体框架。astron-agent 可以引用并加载存放在 SkillHub 里的技能，让技能从开发到上线都有治理、有版本，形成完整生命周期。

相关项目

SkillHub 是 讯飞 Astron 开源生态的一部分。如果 SkillHub 对你有用，这些同门项目可能也适合你：

- astron-agent —— 企业级、商用友好的智能体工作流平台，用来构建下一代 SuperAgent。发布到 SkillHub 的技能可以由 astron-agent 加载并运行。
- astron-rpa —— 面向智能体的 RPA 套件，自带开箱即用的自动化工具，个人和企业都能用。

🌟 展示与分享 —— 你用 SkillHub 做过什么？我们很想听听！
到 Discussions → Show and Tell 分类下，分享你的用例、集成方式或部署故事。

贡献

欢迎贡献。动手之前，请先开 issue 讨论你想改什么。

- 贡献指南：CONTRIBUTING.md
- 行为准则：CODE_OF_CONDUCT.md

📞 支持

- 💬 社区讨论：GitHub Discussions
- 🐛 问题反馈：Issues
- 👾 Discord：加入我们的服务器
- 👥 企业微信群：

企业微信群

许可证

Apache License 2.0