SkillHub CLI完全教程：6步让你的Agent快速发现、安装团队技能

SkillHub CLI完全教程6步让你的Agent快速发现、安装团队技能【免费下载链接】skillhubSelf-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.项目地址: https://gitcode.com/gh_mirrors/sk/skillhubSkillHub CLI 是 SkillHub 官方命令行工具也是企业私有技能注册中心与你的 AI Agent 之间的桥梁。它让团队内部的 Agent 技能包可以被搜索、安装、版本管理和审计——本教程带你通过 6 个简单步骤让 Claude Code、Codex、Cursor 等 Agent 快速发现并安装团队技能。第1步一键安装 SkillHub CLI前置条件本机已安装 Node.jsnpm 或 Bun 均可。# 通过 npm 全局安装 npm install -g astron-team/skillhub # 或者不安装直接用 npx 跑一下验证环境 npx astron-team/skillhublatest version安装成功后执行skillhub version看到版本号即代表 CLI 就绪。第2步配置注册中心并登录CLI 连接哪个 SkillHub 注册中心按以下优先级自动解析--registry url命令行参数SKILLHUB_REGISTRY环境变量本地配置文件~/.skillhub/config.json内置默认地址 大多数团队部署了私有 SkillHub 实例用环境变量固定指向即可export SKILLHUB_REGISTRYhttps://skillhub.your-company.com登录时先在 Web UI 的「个人设置 → API Tokens」页面创建一个 Token然后skillhub login --token sk_xxx skillhub whoami # 验证当前身份login会先验证 Token 有效性再安全存储到~/.skillhub/credentials.jsonLinux/macOS 上自动设置 0600 权限不会把 Token 写入任何项目文件。第3步搜索发现团队技能skillhub search pdf # 关键词搜索 skillhub search --limit 50 # 空查询列出全部技能 skillhub search pdf --json # JSON 输出方便脚本处理输出格式为namespace/slug version summary一眼看清技能归属的命名空间、版本和简介。 在 Web 端你还可以按命名空间、标签、下载量、评分组合过滤与排序权限感知机制保证你只能看到自己有权限的技能包。第4步安装技能到你的 Agentskillhub install pdf-parser # 自动探测 Agent 目录 skillhub install pdf-parser --agent codex # 指定 Agent skillhub install team/my-skill # 团队命名空间坐标 skillhub install pdf-parser --version 1.2.0 # 锁定指定版本 skillhub install pdf-parser --force # 覆盖已存在的安装几个实用细节多种坐标等价team/my-skill、team/my-skill、team--my-skill都指向命名空间team下的my-skill裸 slug 默认解析到global。自动探测CLI 会扫描当前目录识别 claude-code、codex、cursor、gemini-cli、windsurf 等 15 种 Agent 配置目录直接装进对应的 skills 目录见 cli/src/agents/ 与安装逻辑 cli/src/commands/install.ts。user 还是 project 范围交互模式下会询问脚本场景用--scope user或--scope project显式指定。装完即有记录每个技能目录下会生成.skillhub/metadata.json记录来源 registry、命名空间和版本为后续更新、卸载提供依据。第5步本地技能管理skillhub list # 查看所有已安装技能 skillhub list --agent codex # 按 Agent 过滤 skillhub remove pdf-parser # 卸载本地技能 skillhub remove pdf-parser --remote --namespace myspace # 连远程一起删清单损坏或换机迁移后一条命令重建本地清单skillhub doctor自己开发了技能一条命令发布到团队命名空间支持目录或 zip 包skillhub publish ./my-skill --namespace myspace --visibility private可见性三选一public所有人、namespace-only仅命名空间成员、private仅自己——配合命名空间的 Owner / Admin / Member 角色实现完整的团队技能治理。第6步常见故障排查速查表症状快速解决方法认证失败退出码 2skillhub whoami检查必要时重新skillhub login --token sk_xxx网络错误退出码 3curl测试 registry 地址连通性或换--registry安装目录冲突skillhub install skill --force覆盖清单损坏skillhub doctor重建 inventoryCLI 版本过旧skillhub update --check检查、skillhub update自更新 退出码约定0 成功、2 认证失败、3 网络错误、4 文件系统错误、5 参数错误方便脚本化集成。延伸阅读 完整 CLI 中文指南docs/skillhub/guide/cli.md CLI 源码与安装命令实现cli/src/commands/、cli/README.md 让 OpenClaw 等第三方工具接入私有注册中心docs/openclaw-integration.md【免费下载链接】skillhubSelf-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.项目地址: https://gitcode.com/gh_mirrors/sk/skillhub创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考