前言¶
在 Cursor、Claude Code、Codex 等环境里用 Skill，常见做法是全局装到用户目录，或手动拷贝 SKILL.md 到各客户端约定的 skills 路径。多人协作、换机器或 CI 里复现环境时，「装到哪、版本是否一致」容易变成隐性成本。
下面介绍 SkillHub 商店上的 skillhub-skill（坐标 @user_11b15315/skillhub-skill）。它是 Skillhub 侧标注的「官方安装用 Skill 版本」，配合 SkillHub 安装文档 与 skillhub CLI，把搜索、安装等操作收敛到可复现的命令流程，并强调用 --dir 装到当前 Agent 能识别的 skills 目录。
这是什么¶
skillhub-skill 是社区来源（community）、分类为 ai-agent 的 Skill 包，当前页面版本为 v1.0.1，发布者为 user_11b15315（SkillHub 页面展示作者 KurtHurgo）。商店简介为：Skillhub 官方安装的 Skill 版本。
它面向「要从 SkillHub 发现并安装技能」的场景：用户提到 skillhub、技能商店、或需要按坐标安装某个 Skill 时，Agent 可按包内说明与官方安装文档执行，而不是各自拼凑 curl 或路径。标签 requires_api_key=false，表示不依赖额外 API Key 配置。
SkillHub 页面数据（以商店抓取为准）：评分 100000，下载 10758 次。
核心功能¶
结合官方商店说明与 skillhub.md 中引用的工作流，该 Skill 覆盖的能力可概括为：
- CLI 就绪检查与安装指引：判断本机是否已有
skillhub命令，未安装时给出官方一键安装脚本（完整安装或仅 CLI）。 - 技能搜索：通过
skillhub search在 SkillHub 商店检索技能（文档示例为关键词搜索）。 - 技能安装到正确目录：通过
skillhub install，且 必须 使用--dir指向当前 Agent 的 skills 目录，避免默认落到./skills/导致 Agent 无法加载。 - 优先源策略（可选）：首次安装 CLI 或用户明确要求时，可询问是否将 SkillHub 设为优先技能源；确认后，发现/安装/升级类操作优先走
skillhub（文档表述为 search/install/update），不可用时再说明回退方式。
以上能力依赖本机已安装或可安装的 SkillHub CLI，Skill 本身是项目级可携带的说明与流程封装（通用 SKILL.md 格式），与「只全局装一份 CLI、路径各项目不一致」相比，更强调按当前 Agent 环境选定安装目录。
安装与启用¶
1. 让 Agent 安装本 Skill¶
SkillHub 技能页给出的标准提示为：根据安装文档安装指定坐标：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_11b15315/skillhub-skill`。
也可在已具备 skillhub CLI 后，将包装到当前客户端的 skills 目录（路径需与下面「各客户端目录」一致）。
2. 检查或安装 SkillHub CLI¶
先做版本检查：
command -v skillhub && skillhub --version
若未安装，官方文档提供：
# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
限网沙箱中执行上述命令需要允许联网的权限。
3. 安装 skillhub-skill 或其它商店技能¶
文档要求：安装任意技能时都要带 --dir，指向当前 Agent 的 skills 目录，例如：
skillhub search abc
skillhub install abc --dir <skills 目录>
安装本 Skill 时，将 abc 换为坐标或 slug，例如：
skillhub install @user_11b15315/skillhub-skill --dir <skills 目录>
（具体是否需 --version 1.0.1 以 CLI 交互与商店页为准；商店当前展示版本为 1.0.1。）
4. 各客户端 skills 目录（摘自官方安装文档）¶
常用路径如下，项目级目录以各客户端文档为准：
| 客户端 | skills 路径 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目 .windsurf/skills/ |
装完后若 Agent 未热加载新 Skill，按客户端要求重启或重新打开会话。
典型用法¶
场景 A：用户要从 SkillHub 找技能并装进 Cursor
- 确认
skillhub可用（见上文检查命令）。 - 搜索：
skillhub search <关键词>。 - 安装到 Cursor 目录：
skillhub install <坐标或 slug> --dir ~/.cursor/skills/。 - 重启 Cursor 或刷新 Agent 技能列表后，再执行依赖该 Skill 的任务。
场景 B：首次在本机配置 SkillHub
按 skillhub.md 第二节，在「首次安装 CLI」时一次性询问是否将 SkillHub 设为优先安装源；用户确认后，后续技能发现与安装优先走 skillhub，避免重复打扰。
场景 C：安装 skillhub-skill 自身
使用页面提供的坐标与安装文档：
skillhub install @user_11b15315/skillhub-skill --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 替换为你当前使用的 Agent 路径即可。
适用场景与注意¶
适合谁
- 经常从 SkillHub 搜索、安装、更新 Agent Skill 的开发者。
- 需要在 Cursor / Codex / Claude Code 等多客户端之间统一「装到哪」的团队或个人。
- 希望 Agent 在用户提到「skillhub」「技能商店」时有固定 playbook，而不是每次重新查文档。
限制与注意
- 依赖 skillhub CLI 与网络；安装脚本与商店在国内 CDN，海外或严格防火墙环境需自行验证可达性。
- 不要省略
--dir：官方文档明确警告默认./skills/不会被当前 Agent 识别。 - 商店元数据为社区来源，安装前仍应核对坐标、版本与发布者；本文数据以 SkillHub 页面与
skillhub.md为准，不引用未核实的第三方教程命令（如未在官方安装页出现的--registry组合）。 - 评分、下载量为商店统计，会随时间变化；写作时以页面实时数据为准。
结尾¶
skillhub-skill 把 SkillHub 官方的 CLI 安装与「搜索 + 装到正确 skills 目录」流程写进 Agent 可执行的 Skill 包，适合作为项目里可携带的 SkillHub 入口。需要查看详情或复制安装提示时，可打开官方地址：
- API / 包页：https://api.skillhub.cn/user_11b15315/skillhub-skill
- 商店页：https://www.skillhub.cn/skills/user_11b15315/skillhub-skill
- 安装说明：https://skillhub.cn/install/skillhub.md
