iflytek /skillhub

Self-hosted, open-source agent skill registry for enterprises. Publish & version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes.

★ 5,428⑂ 814👁 45⑃ 720● 328▤ 38
JavaApache-2.0Created 2026-03-11skill.xfyun.cn
下载:v0.2.27v0.2.27 ↓0.2.272026-11-13
+6
日增长
5,428
stars
814
forks
45
watchers
720
prs
328
issues
38
releases

README

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



















  



---


  


SkillHub 是一个自托管平台,为团队提供私有的、受治理的智能体技能共享空间。发布技能包,推送到命名空间,让其他人通过搜索发现或通过 CLI 安装。专为防火墙后的本地部署而构建,提供与公共注册中心相同的精致体验。

 ⭐ 如果 SkillHub 适合你的团队,欢迎 Star 本仓库帮助更多团队发现它;点 Watch → Custom → Releases 可在新版本发布时收到通知。

 分享优秀 Skill

优秀的 Skill 在分享中产生更大价值。如果你有一个在真实工作或生活场景中反复打磨、确实好用的
Skill,欢迎分享给 SkillHub 社区,与大家一起丰富开放、实用的 Skill 生态。无论是日常生活、
办公协作、学习研究、旅行活动、内容创作、数据分析还是软件开发,都可以成为有价值的分享。

经过验证的社区贡献还有机会进入精选 Skill 集合,让每个新部署的 SkillHub 开箱即用。不必完成
全部适配后才能参与:你可以先创建 issue,
说明 Skill 的来源和它解决的问题;也可以按照Skill 分享指南
直接提交 PR。

 文档

- 📖 用户指南 — 技能发布、搜索、CLI 使用等用户操作指南
- 🛠️ 开发者文档 — 架构设计、API 参考、本地开发、部署运维等技术文档
- 🐍 Python 示例 — 使用 REST API 在 Python 中搜索、下载和发布技能

 核心特性

- 自托管与私有化 — 部署在您自己的基础设施上。将专有技能保留在防火墙后,完全掌控数据主权。一条 make dev-all 命令即可在本地运行。
- 发布与版本管理 — 上传智能体技能包,支持语义化版本控制、自定义标签(beta、stable)和自动 latest 跟踪。
- 发现 — 全文搜索,支持按命名空间、下载量、评分和时间筛选。可见性规则确保用户只能看到其有权访问的内容。
- 团队命名空间 — 在团队或全局范围下组织技能。每个命名空间拥有自己的成员、角色(Owner / Admin / Member)和发布策略。
- 审核与治理 — 团队管理员在其命名空间内审核;平台管理员控制向全局范围的推广。治理操作记录审计日志以满足合规要求。
- 社交功能 — 收藏技能、评分并跟踪下载量。围绕组织的最佳实践构建社区。
- 账户合并 — 将多个 OAuth 身份和 API 令牌整合到单个用户账户下。
- API 令牌管理 — 为 CLI 和程序化访问生成作用域令牌,采用基于前缀的安全哈希。
- CLI 优先 — 原生 REST API,加上对现有 ClawHub 风格注册中心客户端的兼容层。原生 CLI API 是主要支持路径,协议兼容性持续扩展中。
- 可插拔存储 — 开发环境使用本地文件系统,生产环境使用 S3 / MinIO。通过配置切换。
- 国际化 — 使用 i18next 支持英语、简体中文、俄语和韩语。

 快速开始

使用以下命令启动完整的本地环境:

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


默认命令会拉取 latest 稳定版镜像;如果你想跟随 main 的最新构建,请显式传 --version edge。

配置公网访问地址(生产环境推荐):

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


--public-url 参数用于设置 SkillHub 实例的公网访问地址。配置后:
- CLI 安装命令会显示正确的注册中心地址
- Agent 设置指引会显示正确的 skill.md URL
- OAuth 回调和设备认证链接能正常工作

国内用户(阿里云镜像):

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


重新运行或更新部署时,请保留现有的运行时目录。运行时脚本会复用其中的
.env.release 文件;删除该目录会丢失自定义配置,包括公网访问地址和自动生成的匿名下载
Cookie 密钥。

如果部署遇到问题,请先使用运行时脚本输出的 ps 和 logs 生命周期命令检查状态与日志,
再使用相同的运行时目录重试 up。如果确实需要重新生成配置,请在清除运行时目录之前备份
.env.release。

 前置要求

- Docker & Docker Compose

 访问应用

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

 默认账户

默认执行 make dev-all 时,后端以 local profile 启动。
在这个模式下,本地开发会保留下面两个模拟用户,同时默认创建一个可账号密码登录的 bootstrap 管理员:

- local-user — 普通用户,用于发布和命名空间操作
- local-admin — 超级管理员,用于审核和管理流程

在本地开发中使用 X-Mock-User-Id 请求头切换用户。
本地 bootstrap 管理员默认已在 application-local.yml 中开启:

- 用户名:admin
- 密码:ChangeMe!2026
- 如需关闭,请在启动后端前设置环境变量 BOOTSTRAP_ADMIN_ENABLED=false

通过 runtime.sh 或 compose.release.yml 部署时,发布模板同样默认开启管理员,
使用相同的默认账号密码(admin / ChangeMe!2026),零配置即可登录。
生产环境请务必修改密码——validate-release-config.sh 会拒绝默认值

 停止服务

bash
/tmp/skillhub-runtime/runtime.sh down


 SkillHub CLI

通过命令行安装和管理 Agent 技能:

bash
 安装 CLI
npm install -g @astron-team/skillhub

 或直接运行
npx @astron-team/skillhub@latest version

 登录
skillhub login --token sk_xxx --registry https://skill.xfy

Top issues

Discussions

Latest release

v0.2.27 v0.2.27 2026-11-13
SkillHub v0.2.27

This release introduces curated homepage content, expands system configuration and instance branding, and improves Suite management on small screens, database compatibility, and deployment configuration downloads.

 🌟 Highlights

- Administrator-curated skills and topics, with default recommendations, draft previews, and independent publishing.
- Dedicated configuration sections for site branding, homepage content, sign-in and review, and notifications and maintenance.
- Aligned Flyway dependencies and improved migration compatibility checks for PostgreSQL 16 and 17.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON