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
TA的项目
+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
#934Tracking issue for PR #886: Agent Skill authoring and validation platform (OSPP task 26d8e0076)11 comments · 2026-10-09#1049[Feature] 让 skill:publish token 可以只提交审核,不能 confirm-publish 免审直发 PRIVATE 版本9 comments · 2026-11-02#1035[Feature] 面向非技术用户的 skill 展示:中文展示名/简介/能力说明 + 首页推荐板块6 comments · 2026-10-29#456feat(auth): support standard CAS 2.0/3.0 SSO protocol6 comments · 2026-05-19#990[Feature] Starter skill: edit, execute and replay a small Gooo program4 comments · 2026-10-20#955[Feature] 支持企业 OIDC 登录新用户自动加入指定的公司命名空间4 comments · 2026-10-15#727Feature: optional HOL Guard SecurityScanner backend for skill publish scans4 comments · 2026-08-18#785[Feature] 支持在用户首次登录前预创建用户3 comments · 2026-08-31
Discussions
#1051GitHub 同步的版本号能否和上游 tag/release 对应?0 comments · 2026-11-02#691Where SkillHub sits in the agent-skills stack: collection → harness → registry0 comments · 2026-08-05#559Claude Code 接入 SkillHub 指南0 comments · 2026-06-24#558Welcome to skillhub Discussions!0 comments · 2026-06-24#833Are you using SkillHub?3 comments · 2026-06-15
Latest release
v0.2.27 v0.2.27 2026-11-13SkillHub 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.