name: skillhub-skill-download description: "指导用户如何安装 SkillHub 商店以及如何使用 SkillHub 商店搜索和下载技能。适用于 Windows PowerShell 环境。"
SkillHub 技能下载指南
本技能帮助用户在 Windows 环境下安装 SkillHub 商店，并使用它来搜索和下载各种技能。
1. 安装 SkillHub 商店(本电脑已安装)
1.1 前提条件
- Windows 系统
- 已安装 Git for Windows（包含 Git Bash）
- 已安装 Python（3.x 版本）
1.2 安装步骤
步骤 1：下载安装脚本
在 PowerShell 中执行：
Invoke-WebRequest -Uri "https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh" -OutFile "install.sh"
步骤 2：使用 Git Bash 运行安装脚本（下面的git要使用当前电脑的实际git安装位置）
& "C:\Program Files\Git\bin\bash.exe" -c "cd /d/temp/guotugongjuxiang && bash install.sh"
注意：请将路径
/d/temp/guotugongjuxiang替换为您的实际工作目录路径。
步骤 3：验证安装
安装完成后，SkillHub 会被安装到：
- CLI 位置：
C:\Users\[用户名]\.local\bin\skillhub
2. 使用 SkillHub 商店
2.1 搜索技能
使用 Python 直接运行 CLI 搜索技能：
python "C:\Users\[用户名]\.skillhub\skills_store_cli.py" search [关键词]
示例：
python "C:\Users\Administrator\.skillhub\skills_store_cli.py" search self-improving-agent
2.2 安装技能
请先cd进入技能安装位置的文件夹。
在此目录执行安装技能命令，技能将被安装在当前目录下的skills文件夹中（没有skills目录则自动创建）
安装技能命令：
python "C:\Users\[用户名]\.skillhub\skills_store_cli.py" install [技能名称]
示例：
比如在C:\Users\ZhuanZ\.qclaw目录安装技能agent-browser
cd C:\Users\ZhuanZ\.qclaw
python "C:\Users\ZhuanZ\.skillhub\skills_store_cli.py" install agent-browser
3. 常见问题解决
问题 1：PowerShell 中无法直接运行 curl + bash
原因：
- PowerShell 的
curl是系统别名，不支持-fsSL参数 - Windows 默认没有 bash，无法运行
.sh脚本
解决方案：使用 Git Bash 来执行 Linux 风格的命令。
问题 2：python3 命令找不到
原因：Windows 上 Python 的可执行文件名通常是 python 而不是 python3。
解决方案：
- 修改
C:\Users\[用户名]\.local\bin\skillhub文件，将python3改为python - 或者直接使用
python命令运行 CLI 脚本
问题 3：本电脑技能安装到哪里
请cd 到C:\Users\ZhuanZ.qclaw目录，然后执行安装技能命令。
4. 完整安装示例
以下是一个完整的安装流程示例：
# 1. 进入工作目录，请替换为实际工作目录
cd C:\Users\ZhuanZ\.qclaw
# 2. 下载安装脚本
Invoke-WebRequest -Uri "https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh" -OutFile "install.sh"
# 3. 使用 Git Bash 安装 SkillHub 商店
& "C:\Program Files\Git\bin\bash.exe" -c "cd /d/temp/guotugongjuxiang && bash install.sh"
# 4. 搜索 self-improving-agent 技能
python "C:\Users\Administrator\.skillhub\skills_store_cli.py" search self-improving-agent
# 5. 安装 self-improving-agent-next 技能
python "C:\Users\Administrator\.skillhub\skills_store_cli.py" install self-improving-agent-next
# 6. 验证安装
Get-ChildItem "D:\temp\guotugongjuxiang\skills\self-improving-agent-next"
5. 技能文件结构
安装后的技能通常包含以下文件：
skills/[技能名称]/
├── SKILL.md # 技能说明文档（必需）
├── _meta.json # 技能元数据
├── assets/ # 资源文件
├── hooks/ # 钩子脚本
├── references/ # 参考文档
└── scripts/ # 辅助脚本
6. 更新和卸载
更新 SkillHub CLI
SkillHub 支持自动更新，也可以手动更新：
python "C:\Users\[用户名]\.skillhub\skills_store_cli.py" --upgrade
卸载技能
直接删除技能目录即可：
Remove-Item -Recurse -Force "D:\temp\guotugongjuxiang\skills\[技能名称]"
7. 最佳实践
- 安装前搜索：先使用
search命令查找合适的技能版本 - 查看文档：安装后阅读
SKILL.md了解技能使用方法 - 定期更新：关注技能更新，获取最新功能和修复
- 备份重要技能：对自定义修改的技能进行备份
